Documentación de eSIMTrade
api.esimtrade.com
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.
Autenticación
Cómo funcionan las credenciales de revendedor, qué encabezados se admiten y qué métodos de autenticación aceptan las rutas.
Método de credenciales recomendado
Las nuevas integraciones deben autenticarse con un par generado de código de acceso y clave secreta. Se crean en el portal para revendedores y pueden renovarse o revocarse sin modificar la cuenta.
Las rutas que utilizan requireResellerAccess también aceptan una cookie de sesión válida del revendedor cuando la solicitud procede de una sesión autenticada del portal.
| Encabezado | Obligatorio | Finalidad |
|---|---|---|
| x-access-code | Sí, para autenticación mediante par de claves | Identifica el registro de la clave de API |
| x-secret-key | Sí, para autenticación mediante par de claves | Verifica el secreto compartido |
| x-api-key | Solo para compatibilidad heredada | Modo de compatibilidad con solo el secreto |
| Authorization: Bearer <secret> | Solo para compatibilidad heredada | Modo de compatibilidad con solo el secreto |
Solicitud de planes con autenticación por par de claves
curl --location --request GET 'https://api.esimtrade.com/api/v1/portal/plans' \ --header 'x-access-code: YOUR_ACCESS_CODE' \ --header 'x-secret-key: YOUR_SECRET_KEY'
Límites de solicitudes y alcance del acceso
Cada clave de API tiene su propio límite de solicitudes por minuto. El valor predeterminado que muestra el portal es de 120 solicitudes por minuto. Consulta los ajustes de acceso a la API para ver el límite de tu clave.
Las respuestas de una clave de API se limitan a la cuenta de revendedor propietaria. Una clave no puede consultar los pedidos, el perfil, el saldo ni el inventario de eSIM de otro revendedor.
Si se revoca una clave de API o caduca, las rutas para revendedores devuelven HTTP 401 (no autorizado).