Guides
Límites de solicitudes y errores
Public API per-account rate limits, error response format, status codes and caching guidance.
On this page
Rate limits#
Nota
La API pública y el MCP autenticado comparten una cuota por hora para cada socio (20.000 por defecto). Añadir o rotar claves no la aumenta.
La ventana de 3,600 segundos empieza con la primera solicitud; el límite por minuto también se aplica. Las cuotas cuentan llamadas, no MB transferidos. La configuración operativa puede cambiar la cuota.
Los lotes de MCP admiten hasta 100 mensajes y cada mensaje cuenta como una llamada. Un lote que supere la cuota disponible devuelve 429 antes de ejecutarse.
X-RateLimit-Hour-Limit · X-RateLimit-Hour-Remaining · X-RateLimit-Hour-Reset
Estas cabeceras indican el límite por hora, las llamadas restantes y la hora de restablecimiento (segundos Unix). Al agotar el límite por hora se devuelve HTTP 429 y Retry-After en segundos. Las llamadas rechazadas por el límite por minuto no cuentan para la cuota por hora.
De forma predeterminada, cada cuenta de socio tiene un límite de 600 solicitudes por minuto. Si lo superas, recibes 429 rate_limited.
Propina
Status codes#
| HTTP | Significado |
|---|---|
| 200 | Completado |
| 400 | Parámetros no válidos |
| 401 invalid_api_key | Clave ausente, incorrecta o revocada |
| 404 | ID de eSIM desconocido |
| 429 rate_limited | Límite de solicitudes superado |
Error format#
// 401 — missing, invalid or revoked key
{
"error": "invalid_api_key",
"message": "Missing or invalid API key. Create one at https://www.esimoa.com/developers/dashboard"
}
// 429 — too many requests for this key
{ "error": "rate_limited", "message": "Rate limit exceeded (600 requests per minute)." }
// 400 — invalid parameters / 404 — unknown eSIM id
{ "statusCode": 404, "message": "eSIM not found", "error": "Not Found" }Caching#
Los precios cambian a menudo: guarda en caché los resultados de búsqueda unos minutos como máximo.