Saltar al contenido
Documentación de eSIMTrade
API pública
api.esimtrade.com
cURL
JavaScript
HTTP
JSON
Documentación práctica y clara de la API para revendedores.
Empieza por la autenticación, comprueba el saldo, consulta los planes y después trabaja con pedidos e inventario. Cada página de ruta explica la autenticación, los campos de la solicitud, la respuesta y ejemplos que puedes copiar.
Consulta rápida
Rutas disponibles
Ejemplos para copiar
Primeros pasos
Clave de API o sesión
Errores y códigos de estado
Respuestas HTTP habituales de las rutas de la API para revendedores y cómo interpretarlas.
Guía de estados HTTP
La API de eSIMTrade para revendedores devuelve códigos HTTP estándar, no tablas numéricas de errores específicas de algunos proveedores. Esto permite gestionar el flujo de las integraciones y las políticas de reintento de forma más clara.
| Estado | Significado | Causa habitual |
|---|---|---|
| 400 | Solicitud incorrecta | Falta un parámetro obligatorio o un campo del cuerpo |
| 401 | No autorizado | Credenciales ausentes, no válidas, caducadas o revocadas |
| 402 | Pago requerido | Saldo prepago insuficiente en la cuenta del revendedor para realizar la compra |
| 403 | Acceso prohibido | La sesión está autenticada, pero no tiene permiso para realizar esta acción |
| 404 | No encontrado | No se encontró el ICCID de la cuenta ni el registro asociado al revendedor |
| 409 | Conflicto | Conflicto con una compra duplicada o una solicitud idempotente |
| 429 | Demasiadas solicitudes | Se ha superado el límite de solicitudes de la clave |
| 500 | Error del servidor | Error inesperado del servicio |
Ejemplo de respuesta de error
JSON
{
"error": "API rate limit exceeded"
}En esta página