Network operations staffed around the clock
Skyroute
EN · EnglishEN
Hablar con ventasRequest access
DEVELOPERS / API

Construir en rutas mensurables.

Utilice una clave de API de alcance de su cuenta. Solicitudes de uso Autenticación del portador y retorno JSON. Comience con el mercado, luego envíe tráfico usando IDs aprobados.

API REFERENCE

Puntos finales básicos.

Use https://129.146.81.159/api/v1 for this site. The API Keys page creates scoped Bearer keys. EUR prices appear after rate conversion; IDs and wallet balances depend on your account.

AUTORICACIÓN

Clave y alcances del portador

Establecer el encabezado de Autorización en cada solicitud. Una clave desaparecida o revocada devuelve 401; una clave sin el alcance requerido devuelve 403. Las claves de API se muestran en su totalidad sólo cuando se crean.

REQUEST HEADER
Authorization: Bearer YOUR_API_KEY
GET /api/v1/marketplace

Mercado de rutas

Requisitos marketplace:readFiltro por destino, operador y 1h, 24h or 7d ventana. Las respuestas de los clientes contienen alias de ruta y precios de los clientes, sin identidad de portador.

SOLICITUD
GET /api/v1/marketplace?destination=India&operator=Airtel&window=24h
200 RESPONSE · EJECUCIÓN
{
  "selection": {"destination":"India","operator":"Airtel","window":"24h"},
  "filters": {"destinations":["India"],"operators":["Airtel"],"windows":["1h","24h","7d"]},
  "routes": [{"alias":"R-07","label":"Priority","price":0.188,"delivery_rate":96,
    "speed_ms":1200,"sample_count":420,"cost_per_delivered":0.19583,
    "state":"shown","best_value":true,"insufficient_data":false}],
  "route_policy": {"source":"unassigned_default","rule_id":null,"mode":"auto","default_route":null},
  "auto_route": true
}
POST /api/v1/sms/send

Enviar SMS

Requisitos sms:send, an approved sender ID, a plan, enough wallet funds and a unique idempotency key. Reuse the key only to retry the same send; a changed request with the same key returns 409. The request creates a local queued or scheduled batch. Carrier delivery requires a connected provider; this response is not a delivery receipt.

JSON REQUEST BODY
{
  "idempotency_key": "11111111-1111-4111-8111-111111111111",
  "to": ["+919812345670"],
  "message": "Your code is 448120",
  "sender_id": "SKYOTP",
  "route": "auto",
  "destination": "India",
  "operator": "Airtel"
}
201 RESPONSE · EJECUCIÓN
{
  "batch_id": "SMS-EXAMPLE123",
  "status": "queued",
  "route": "R-07",
  "recipients": 1,
  "segments": 1,
  "route_selection_source": "unassigned_default",
  "route_assignment_source": "unassigned_default",
  "route_assignment_rule_id": null,
  "cost": 0.19,
  "currency": "EUR",
  "wallet_balance": 4819.81,
  "message": "Queued locally. Delivery requires a connected carrier."
}
POST /api/v1/voip/call

Preflight de voz

Requisitos voip:call, an approved caller ID, an active plan, funds and a secure SIP WebSocket endpoint. A successful response authorizes the connected SIP browser phone to place a call; this request alone does not dial.

JSON REQUEST BODY
{
  "to": "+442079460102",
  "caller_id": "+15550001111"
}
200 RESPONSE · EJECUCIÓN
{
  "authorized": true,
  "to": "+442079460102",
  "caller_id": "+15550001111",
  "route_alias": "V-01",
  "selection_source": "unassigned_default",
  "message": "Preflight passed. Place the call through the connected SIP.js browser phone."
}
ERROR STATES

Maneja una razón, luego vuelve a entrar.

401 significa que la clave está desaparecida o revocada; 403 significa que la clave carece del alcance requerido o la cuenta está suspendida. 402 pide un plan o billetera arriba. 422 Lleva validación de campo o errores de política; 503 significa que un servicio requerido no está disponible.

401 RESPONSE · EJECUCIÓN
{"message":"Bearer API key required."}