Funzionalità sperimentali
Chargetrip introduce nuove funzionalità significative attraverso un programma sperimentale strutturato. Ti offre accesso anticipato per valutare le funzionalità in arrivo e influenzarne la progettazione prima che schemi e contratti diventino permanenti.
Tipi di funzionalità sperimentali
- Nuove operazioni: query, mutation o subscription completamente nuove.
- Estensioni di operazioni esistenti: nuovi argomenti facoltativi o campi di output aggiunti a operazioni stabili esistenti.
Fasi delle funzionalità sperimentali
| Dimensione | Alpha | Beta |
|---|---|---|
| Prontezza per la produzione | Assolutamente sconsigliata per gli ambienti di produzione. | Adatta a progetti pilota controllati. Sconsigliata per i flussi mission-critical. |
| Attivazione | Disattivata per impostazione predefinita. Richiede un’adesione esplicita nella Dashboard. | Attivata per impostazione predefinita per tutti i client. |
| Stabilità | Stabile ma soggetta a frequenti modifiche dello schema. | Stabile. Può avere modifiche minori dello schema. |
| Indicatore nello schema | Contrassegnata con [ALPHA] nelle descrizioni dei campi dello schema. | Contrassegnata con [BETA] nelle descrizioni dei campi dello schema. |
| Avviso di interruzione | Nessuno. Soggetta a modifica o ritiro immediati. | Contatto diretto proattivo con i clienti che stanno integrando attivamente. |
Per le garanzie offerte dalle funzionalità stabili, consulta il ciclo di vita dell’API.
Best practice
- Usa le funzionalità alpha per valutazioni in sandbox, proof of concept e feedback. Se ne rilasci una comunque, non riceverai alcun avviso né protezione di compatibilità quando cambia.
- Se esponi funzionalità beta agli utenti finali, mostra un badge “beta” così sapranno che la funzionalità si sta ancora stabilizzando.
Ciclo di graduazione
- Da Alpha a Beta
Quando la funzionalità e lo schema raggiungono una maturità sufficiente, la funzionalità passa a beta. Il tag nella descrizione passa da
[ALPHA]a[BETA], l’accesso viene attivato per impostazione predefinita per tutti i clienti e le modifiche vengono annunciate nelle Note di rilascio. - Da Beta a Stabile
Quando affidabilità e maturità sono state validate su più client, il tag
[BETA]nella descrizione e gli avvisi a runtime vengono rimossi e la funzionalità passa al ciclo di vita stabile.
Prezzi
- Le richieste alle operazioni contrassegnate come sperimentali sono gratuite.
- Le richieste a endpoint stabili che includono argomenti di input o campi di output sperimentali facoltativi sono addebitate in base al tuo piano di abbonamento.
Avvisi programmatici
Per mantenere il tuo team di sviluppo consapevole delle dipendenze sperimentali nel traffico attivo, le risposte dell’API che usano funzionalità alpha o beta restituiscono metadati di avviso nel blocco extensions di GraphQL:
Esempio di avviso di una funzionalità alpha
Esempio di avviso di una funzionalità beta
Questo contenuto ti è stato utile?