Overview
API pública (/v1)
Shared rules of the /v1 API: base URL, response envelope, pagination and response language.
URL base#
Envía todas las solicitudes por HTTPS a la dirección de abajo. Se necesita una clave de la API pública (Autenticación), y todas las respuestas son JSON.
https://api.esimoa.com/v1Endpoints#
| Endpoint | Descripción |
|---|---|
| GET /v1/esims | Buscar eSIM |
| GET /v1/esims/:id | Consigue una eSIM |
| GET /v1/countries | Listar países |
| GET /v1/openapi.json | Especificación OpenAPI 3.1 (no requiere clave) |
Response envelope#
Las respuestas correctas siempre incluyen "success": true. Las listas llegan en items y un resultado único en item.
// List endpoints
{ "success": true, "items": [ ... ], "total": 42, "limit": 10, "offset": 0, "sort": "price" }
// Detail endpoint
{ "success": true, "item": { ... } }Para las respuestas de error y los códigos de estado, consulta Límites de solicitudes y errores.
Paginación#
Las listas se paginan con limit (1–50, predeterminado 10) y offset. offset siempre se redondea a la baja a un múltiplo de limit; por ejemplo, limit=10, offset=15 se trata como offset=10. El offset de la respuesta es el valor realmente utilizado y total es el recuento completo.
Propina
Response language#
El parámetro lang (ko | en | ja | zh-CN | zh-TW, por defecto en) define el idioma de los nombres de países, los títulos de los productos y la página de compra a la que apunta url. Haz que coincida con el idioma de tu usuario.
Prices & caching#
Los precios (priceKrw) son el precio de venta de esimoa en KRW como número entero. Los precios cambian a menudo: guarda en caché los resultados de búsqueda unos minutos como máximo; el pago de esimoa es siempre la referencia del importe cobrado.