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
Inventario
Clave de API o sesión
POST
Crear recarga
Realiza una recarga para un ICCID de tu cuenta con un slug válido devuelto por la consulta de disponibilidad.
Ruta de API
POST /portal/topups
Funcionamiento de la ruta
Esta ruta solicita una recarga al proveedor después de verificar que el ICCID pertenece a tu cuenta. Utiliza el slug devuelto por la ruta de disponibilidad; no inventes uno manualmente.
| Campo del cuerpo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| iccid | string | Sí | ICCID de tu cuenta |
| slug | string | Sí | Slug de recarga devuelto por la consulta de disponibilidad |
| qty | number | No | Cantidad opcional; el valor predeterminado es 1 |
Crear recarga
cURL
curl --location --request POST 'https://api.esimtrade.com/api/v1/portal/topups' \
--header 'x-access-code: YOUR_ACCESS_CODE' \
--header 'x-secret-key: YOUR_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{
"iccid": "8944501234567890123",
"slug": "japan-topup-3gb",
"qty": 1
}'Ejemplo de error de validación
JSON
{
"error": "Missing iccid or slug"
}En esta página