Network operations staffed around the clock
Skyroute
EN · EnglishEN
Contacter les ventesRequest access
DÉVELOPPEMENTS / API

S'appuyer sur des itinéraires mesurables.

Utilisez une clé API scoped depuis votre compte. Les demandes utilisent l'authentification du porteur et renvoient JSON. Commencez par le marché, puis soumettez le trafic en utilisant des ID approuvés.

RÉFÉRENCE DE L'API

Principaux paramètres.

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.

AUTHENTICATION

Clé et champs d'application du porteur

Définir l'en-tête Autorisation sur chaque demande. Une clé manquante ou révoquée renvoie 401; une clé sans la portée requise renvoie 403. Les clés API ne sont affichées en entier qu'une fois créées.

DEMANDE D'AIDE
Authorization: Bearer YOUR_API_KEY
GET /api/v1/marketplace

Marché des routes

Nécessaire marketplace:read. Filtre par destination, opérateur et un 1h, 24h or 7d fenêtre. Les réponses des clients contiennent des alias de route et des prix des clients, sans identité de transporteur.

DEMANDE
GET /api/v1/marketplace?destination=India&operator=Airtel&window=24h
200 RÉPONSE · EXEMPLE SHAPE
{
  "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

Envoyer un SMS

Nécessaire 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 DEMANDE D'ORGANISATION
{
  "idempotency_key": "11111111-1111-4111-8111-111111111111",
  "to": ["+919812345670"],
  "message": "Your code is 448120",
  "sender_id": "SKYOTP",
  "route": "auto",
  "destination": "India",
  "operator": "Airtel"
}
201 RÉPONSE · EXEMPLE SHAPE
{
  "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

Voix avant le vol

Nécessaire 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 DEMANDE D'ORGANISATION
{
  "to": "+442079460102",
  "caller_id": "+15550001111"
}
200 RÉPONSE · EXEMPLE SHAPE
{
  "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."
}
ÉTATS ERREURS

Gérez une raison, puis réessayez.

401 signifie que la clé est manquante ou révoquée; 403 signifie que la clé manque de la portée requise ou que le compte est suspendu. 402 demande un plan ou un supplément de portefeuille. 422 comporte des erreurs de validation de champ ou de politique; 503 signifie qu'un service requis n'est pas disponible.

401 RÉPONSE · EXEMPLE EXACT
{"message":"Bearer API key required."}