Il catalogo prodotti

Il catalogo è l'elenco dei prodotti che puoi acquistare e rivendere. Ogni cliente Sterna ha un proprio catalogo, già personalizzato: i prodotti che vedi e i prezzi indicati sono quelli applicati al tuo account.

A cosa serve

Consultare il catalogo è il passo che precede la creazione di un ordine. Da qui ottieni due informazioni indispensabili per ordinare:

• l'identificativo (id) di ogni prodotto, che dovrai indicare al momento dell'ordine;
• il prezzo di ogni prodotto, così da sapere in anticipo quanto ti costerà.

L'endpoint

Per ottenere il catalogo si usa questo endpoint:

GET /v1/catalog

L'indirizzo completo della chiamata è https://api.sterna.mobi/v1/catalog.

Esempio di richiesta

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

Esempio di risposta

L'API risponde con l'elenco dei prodotti disponibili:

{
  "count": 2,
  "products": [
    {
      "id": "e9e3cce1-...",
      "name": "STERNA Europe Sud",
      "service_type": "esim",
      "price_eur": 14.00
    }
  ]
}

Come leggere la risposta

La risposta contiene:

• `count` — Il numero di prodotti presenti nel tuo catalogo.
• `products` — L'elenco dei prodotti. Per ciascuno trovi i campi descritti qui sotto.

Per ogni prodotto, i campi principali sono:

• `id` — L'identificativo univoco del prodotto. È il valore che userai per creare un ordine: tienilo da parte.
• `name` — Il nome del prodotto.
• `service_type` — Il tipo di servizio. Per i pacchetti dati eSIM vale esim.
• `price_eur` — Il prezzo del prodotto, in euro, applicato al tuo account.