Saltar al contenido
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
Pedidos
Clave de API o sesión
GET

Consultar pedidos

Consulta el historial de pedidos del revendedor por páginas, con filtros opcionales de estado y texto.

Ruta de API

GET /reseller/orders

Funcionamiento de la ruta

Esta ruta devuelve los pedidos de la cuenta autenticada del revendedor, empezando por los más recientes. Los resultados admiten paginación y filtros de texto y estado.

Parámetro de consultaTipoDescripción
pagenumberNúmero de página; valor predeterminado: 1
pageSizenumberElementos por página; valor predeterminado: 20 y máximo: 100
statusstringFiltro opcional por estado del pedido
qstringBúsqueda opcional por número de pedido del proveedor, nombre del paquete y slug

Lista paginada de pedidos

cURL
curl --location --request GET 'https://api.esimtrade.com/api/v1/reseller/orders?page=1&pageSize=20' \
--header 'x-access-code: YOUR_ACCESS_CODE' \
--header 'x-secret-key: YOUR_SECRET_KEY'

Lista filtrada de pedidos

cURL
curl --location --request GET 'https://api.esimtrade.com/api/v1/reseller/orders?status=active&q=japan' \
--header 'x-access-code: YOUR_ACCESS_CODE' \
--header 'x-secret-key: YOUR_SECRET_KEY'

Estructura de la respuesta real

JSON
{
  "page": 1,
  "pageSize": 5,
  "total": 2,
  "orders": [
    {
      "providerOrderNo": "B26022703140001",
      "slug": "PK_0.5_Daily",
      "packageCode": "PUX79Y0PK",
      "packageName": "Pakistan 500MB/Day",
      "locationCode": "PK",
      "status": "cancel",
      "quantity": 1,
      "sellPrice": "0.5",
      "totalSellPrice": "0.5"
    }
  ]
}

URL base

https://api.esimtrade.com/api/v1