Primi passi

Questa è la guida rapida per portarti dal primo accesso al primo eSIM in quattro passi. Ogni passo mostra l'essenziale — un esempio minimo e la chiamata chiave — e rimanda alla pagina dedicata per i dettagli completi.

Consiglio: inizia in test. Con una chiave stk_test_... gli ordini sono simulati, non hai costi e nessun eSIM reale viene consegnato, ma il comportamento dell'API è identico a quello live. Passa alla chiave live solo quando il flusso end-to-end funziona. Vedi "Ambiente test e live".

Il percorso completo: autenticati, guarda il catalogo, crea un ordine, ritira l'eSIM.

Passo 1 — Autenticati

La tua API key si crea dal pannello Sterna e si usa nell'header Authorization: Bearer. Una chiamata GET /v1/me ti conferma che la chiave funziona e ti dice quale account e quale ambiente sta usando.

curl https://api.sterna.mobi/v1/me \
  -H "Authorization: Bearer stk_test_..."

Per i dettagli vedi "Autenticazione" (formato dell'header, errori 401) e "Chiavi API" (come si creano e come si proteggono).

Passo 2 — Guarda il catalogo

Recupera l'elenco dei prodotti disponibili al tuo account e prendi l'id del prodotto che ti serve. Userai quell'id come product_id nel passo successivo.

curl https://api.sterna.mobi/v1/catalog \
  -H "Authorization: Bearer stk_test_..."

Per i dettagli (struttura del prodotto, prezzi, disponibilità per ambiente) vedi "Il catalogo prodotti".

Passo 3 — Crea un ordine

Invia product_id e quantity. La risposta arriva subito con l'ordine in stato processing: l'eSIM non è ancora pronto, viene preparato poco dopo in modo asincrono. Conserva l'id dell'ordine, ti serve per ritirarlo.

curl -X POST https://api.sterna.mobi/v1/orders \
  -H "Authorization: Bearer stk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"product_id":"prod_xxx","quantity":1}'

Per i dettagli (campi richiesti, validazioni, esempi di risposta completa) vedi "Creare un ordine".

Passo 4 — Recupera l'eSIM

L'ordine passa da processing a completed quando l'eSIM è pronto. Quando è completed, la risposta a GET /v1/orders/{id} contiene i dati dell'eSIM: ICCID, codice di attivazione e QR pronti da consegnare al tuo cliente.

curl https://api.sterna.mobi/v1/orders/{id} \
  -H "Authorization: Bearer stk_test_..."

Per i dettagli (stati intermedi, come accorgersi che l'ordine è pronto, gestione dei fallimenti) vedi "Ciclo di vita dell'ordine".

E adesso?

Prima di andare in produzione, leggi "Ambiente test e live": come passare dalla chiave stk_test_... alla chiave stk_live_... senza sorprese.
Per capire il credito disponibile e come si consuma a ogni ordine, vedi "Il plafond".
Se il tuo account fa parte di un gruppo (account principale + sotto-account), vedi "Ordini in una rete".