Overview
API pubblica (/v1)
Shared rules of the /v1 API: base URL, response envelope, pagination and response language.
URL di base#
Invia ogni richiesta via HTTPS all’indirizzo qui sotto. È necessaria una chiave dell’API pubblica (Autenticazione), e ogni risposta è in JSON.
https://api.esimoa.com/v1Endpoint#
| Endpoint | Descrizione |
|---|---|
| GET /v1/esims | Cerca eSIM |
| GET /v1/esims/:id | Ottieni un’eSIM |
| GET /v1/countries | Elenca paesi |
| GET /v1/openapi.json | Specifica OpenAPI 3.1 (nessuna chiave richiesta) |
Response envelope#
Le risposte riuscite includono sempre "success": true. Gli elenchi arrivano in items e un singolo risultato in item.
// List endpoints
{ "success": true, "items": [ ... ], "total": 42, "limit": 10, "offset": 0, "sort": "price" }
// Detail endpoint
{ "success": true, "item": { ... } }Per le risposte di errore e i codici di stato, consulta Limiti di richieste ed errori.
Paginazione#
Gli elenchi sono paginati con limit (1–50, predefinito 10) e offset. offset viene sempre arrotondato per difetto a un multiplo di limit — ad esempio limit=10, offset=15 viene trattato come offset=10. L’offset nella risposta è il valore effettivamente usato e total è il conteggio completo.
Mancia
Response language#
Il parametro lang (ko | en | ja | zh-CN | zh-TW, predefinito en) imposta la lingua dei nomi dei paesi, dei titoli degli articoli e della pagina d’acquisto a cui punta url. Usa la lingua del tuo utente.
Prices & caching#
I prezzi (priceKrw) sono il prezzo di vendita di esimoa in KRW come numero intero. I prezzi cambiano spesso: memorizza nella cache i risultati di ricerca per pochi minuti al massimo; il checkout di esimoa è sempre il riferimento per l’importo addebitato.