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
Cuenta
Clave de API o sesión
GET

Métricas

Consulta las métricas del revendedor, los ingresos a lo largo del tiempo, los principales países y el uso agregado de la API por intervalo.

Ruta de API

GET /reseller/metrics

Funcionamiento de la ruta

Esta ruta proporciona los datos analíticos del revendedor. Agrupa pedidos, eventos de pedidos y movimientos del saldo en métricas resumidas, datos por país, evolución de ingresos y estadísticas de uso de la API para el intervalo seleccionado.

Parámetro de consultaTipoDescripción
rangestringValores admitidos: 7d, 30d y 12m. El valor predeterminado es 30d.

Métricas de los últimos 30 días

cURL
curl --location --request GET 'https://api.esimtrade.com/api/v1/reseller/metrics?range=30d' \
--header 'x-access-code: YOUR_ACCESS_CODE' \
--header 'x-secret-key: YOUR_SECRET_KEY'

Estructura de la respuesta real

JSON
{
  "range": "30d",
  "metrics": {
    "walletBalanceCents": 5900,
    "walletBalanceUsd": "59.00",
    "totalSales": 0,
    "activeEsims": 0,
    "totalOrders": 0,
    "topCountries": [],
    "revenueSeries": [
      { "label": "Apr 17", "revenue": 0, "orders": 0 }
    ],
    "apiUsage": {
      "purchaseCalls": 0,
      "syncCalls": 0,
      "walletActions": 3,
      "refundEvents": 0,
      "successRate": 100
    }
  }
}

URL base

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