API eSIM

Costruisci l'intera connessione.

Porta la connettività nella tua applicazione attraverso un unico modello di servizio. Collega il catalogo a un acquisto autorizzato, segui l'evasione e l'installazione, poi aiuta i clienti a gestire il servizio acquistato. Mantieni il controllo del percorso nella tua esperienza cliente.

Esplora la piattaforma eSIM

Un'integrazione che puoi seguire

ESEMPIO

BIRD · CONNECTIVITY

Un servizio. Record collegati.

1

Scopri e seleziona

Leggi copertura, termini, prezzo e idoneità.

2

Acquista e attiva

Segui un ordine accettato fino al suo esito.

3

Installa e usa

Risolvi la configurazione privata e osserva il primo utilizzo.

Flusso di integrazione illustrativo. Segui il contratto API corrente per le operazioni supportate e il comportamento di recupero.

Parti dal contratto

Modella il servizio che il tuo cliente sta acquistando.

Un profilo identifica la eSIM, un pacchetto descrive un'indennità e un ordine registra l'acquisto. Un abbonamento ricorrente aggiunge periodi di fatturazione e continuità del servizio. Collega queste identità nella tua applicazione senza unificare i loro stati diversi.

Leggi prima di scrivere

Scopri le offerte e le funzionalità effettive per il cliente previsto. Usa i prezzi pubblicati e l'idoneità corrente anziché mantenere un catalogo separato hardcoded nell'app.

Conserva l'intento accettato

Preserva l'offerta selezionata e l'identità della richiesta durante l'acquisto. Segui l'ordine esistente dopo una risposta incerta, così il recupero non diventa un secondo addebito accidentale.

Costruisci un percorso completo

Collega l'acquisto a un dispositivo funzionante.

Segui l'ordine attraverso l'accettazione finanziaria e il provisioning, poi fornisci un percorso di installazione privato. Riporta l'esito effettivo a ogni passaggio invece di indicare il cliente come connesso quando il checkout è completato.

Mantieni le credenziali private

Fornisci le credenziali di installazione attraverso l'esperienza cliente autorizzata. Escludile dalla telemetria, dal Markdown pubblico, dalle segnalazioni di bug e dai messaggi di supporto generale.

Reagisci allo stato osservato

Usa gli eventi e le letture supportate per il servizio. Conserva i tempi di osservazione, gestisci esplicitamente le informazioni mancanti e lascia che la tua interfaccia riprenda dallo stato effettivamente ricevuto.

Gestisci l'integrazione

Integra il recupero nell'implementazione.

Testa un acquisto controllato, l'installazione e il primo utilizzo, poi un'operazione interrotta o rifiutata. Usa le stesse identità di servizio per collegare supporto, registri finanziari e modifiche al ciclo di vita.

Lavora con il tuo agente di codifica

Fornisci all'agente la descrizione API corrente e la guida al task pertinente. Chiedigli di mappare le operazioni supportate, implementare il flusso autorizzato e mostrare evidenza dell'esito cliente completato.

Porta l'acquisizione lungo tutto il percorso

Mantieni gli identificatori della campagna con l'acquisizione e il passaggio del cliente. Collegali alla conversione di business registrata nella tua applicazione; passare un parametro query è solo una parte dell'attribuzione.

Domande sulla API eSIM

L'API eSIM è solo un endpoint per codici di installazione?
No. Un'integrazione utile copre anche la scoperta delle offerte, l'acquisto, l'evasione, lo stato del servizio e la gestione continua. Le credenziali di installazione sono una parte riservata di questo ciclo di vita.
Un agente di coding può costruire l'integrazione?
Un agente può lavorare dalla descrizione corrente dell'API, dalle guide operative e dalla tua applicazione. Fagli ispezionare le operazioni supportate e dimostrare un percorso completo controllato; non dare per scontato che un metodo esista basandoti su un esempio di marketing.
Come gestire una risposta di acquisto incerta?
Conserva la richiesta originale e l'identità dell'ordine, poi usa il comportamento di recupero documentato per determinarne l'esito. Avviare un nuovo acquisto può generare un addebito o un servizio aggiuntivo.
Cosa includere nella misurazione delle conversioni?
Registra il risultato di business che intendi ottimizzare, come un acquisto completato o un primo utilizzo verificato. Preserva il contesto di acquisizione attraverso il passaggio pertinente e collegalo a quel risultato senza includere credenziali di installazione private.

Mettilo in pratica.

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Ottieni un brief di implementazione

Inizia con un percorso di integrazione completo.

Mappa le operazioni supportate di catalogo, acquisto e installazione nella tua applicazione. Prova il recupero con lo stesso ordine prima di estendere l'integrazione.

Inizia con un canale.
Aggiungi gli altri quando sei pronto.

Una chiave API di test è subito tua. La produzione si sblocca quando aggiungi un metodo di pagamento e verifichi un mittente.

Usi Claude Code, Cursor o Codex? Copia un prompt di configurazione e il tuo agente installerà la CLI e le skill di Bird per te. Scegli il tuo:

Cursor