Network operations staffed around the clock
Skyroute
EN · EnglishEN
Vertrieb kontaktierenRequest access
Entwickler/API

Bauen Sie auf messbaren Routen.

Verwenden Sie einen erweiterten API-Schlüssel aus Ihrem Konto. Anfragen verwenden Bearer-Authentifizierung und geben JSON zurück. Beginnen Sie mit dem Marktplatz und übermitteln Sie dann Traffic mit genehmigten IDs.

API REFERENZ

Kernendpunkte.

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.

ACHTUNG

Bearer Key und Scopes

Legen Sie den Autorisierungs-Header für jede Anforderung fest. Ein fehlender oder widerrufener Schlüssel gibt 401 zurück; ein Schlüssel ohne den erforderlichen Umfang gibt 403 zurück. API-Schlüssel werden nur beim Erstellen vollständig angezeigt.

ANTRAGGEBER
Authorization: Bearer YOUR_API_KEY
GET /api/v1/marketplace

Routenmarkt

Erforderlich marketplace:readFilter nach Ziel, Betreiber und a 1h, 24h or 7d Fenster. Kundenantworten enthalten Routenaliase und Kundenpreise ohne Carrier-Identität.

ANTRAG
GET /api/v1/marketplace?destination=India&operator=Airtel&window=24h
200 Antworten · BEISPIEL
{
  "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

Senden Sie SMS

Erforderlich 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 ANTRAGSTELLE
{
  "idempotency_key": "11111111-1111-4111-8111-111111111111",
  "to": ["+919812345670"],
  "message": "Your code is 448120",
  "sender_id": "SKYOTP",
  "route": "auto",
  "destination": "India",
  "operator": "Airtel"
}
201 ANTWORT · BEISPIEL
{
  "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

Sprachvorflug

Erforderlich 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 ANTRAGSTELLE
{
  "to": "+442079460102",
  "caller_id": "+15550001111"
}
200 Antworten · BEISPIEL
{
  "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."
}
FEHLERSTAATEN

Behandeln Sie einen Grund, dann versuchen Sie es erneut.

401 bedeutet, dass der Schlüssel fehlt oder widerrufen wird; 403 bedeutet, dass dem Schlüssel der erforderliche Umfang fehlt oder das Konto gesperrt wird. 402 fragt nach einem Plan oder Wallet Top-up. 422 Feldvalidierung oder Politikfehler enthält; 503 bedeutet, dass ein erforderlicher Dienst nicht verfügbar ist.

401 Antwort · GENAUES BEISPIEL
{"message":"Bearer API key required."}