Network operations staffed around the clock
Skyroute
EN · EnglishEN
Talk to salesRequest access
डेवलपर / API

मापने योग्य रूटों पर बनाएँ।

अपने खाते की सीमित अधिकार वाली API कुंजी इस्तेमाल करें। अनुरोध Bearer प्रमाणीकरण इस्तेमाल करते हैं और JSON लौटाते हैं। पहले मार्केटप्लेस देखें, फिर स्वीकृत ID से ट्रैफ़िक भेजें।

API संदर्भ

मुख्य एंडपॉइंट।

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.

प्रमाणीकरण

Bearer कुंजी और अधिकार

हर अनुरोध में Authorization हेडर दें। गुम या रद्द कुंजी पर 401 और आवश्यक अधिकार के बिना कुंजी पर 403 मिलता है। API कुंजी केवल बनते समय पूरी दिखाई जाती है।

अनुरोध हेडर
Authorization: Bearer YOUR_API_KEY
GET /api/v1/marketplace

रूट मार्केटप्लेस

आवश्यक है marketplace:read। गंतव्य, ऑपरेटर और 1h, 24h or 7d समय अवधि से फ़िल्टर करें। ग्राहक प्रतिक्रियाओं में कैरियर पहचान के बिना रूट उपनाम और ग्राहक मूल्य होते हैं।

अनुरोध
GET /api/v1/marketplace?destination=India&operator=Airtel&window=24h
200 प्रतिक्रिया · उदाहरण प्रारूप
{
  "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

SMS भेजें

आवश्यक है 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 अनुरोध बॉडी
{
  "idempotency_key": "11111111-1111-4111-8111-111111111111",
  "to": ["+919812345670"],
  "message": "Your code is 448120",
  "sender_id": "SKYOTP",
  "route": "auto",
  "destination": "India",
  "operator": "Airtel"
}
201 प्रतिक्रिया · उदाहरण प्रारूप
{
  "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

वॉइस पूर्व-जाँच

आवश्यक है 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 अनुरोध बॉडी
{
  "to": "+442079460102",
  "caller_id": "+15550001111"
}
200 प्रतिक्रिया · उदाहरण प्रारूप
{
  "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."
}
त्रुटि स्थितियाँ

कारण समझें, फिर कोशिश करें।

401 का अर्थ है कि कुंजी गुम है या रद्द हो चुकी है; 403 का अर्थ है कि कुंजी के पास आवश्यक अधिकार नहीं हैं या खाता निलंबित है। 402 योजना या वॉलेट में धन जोड़ने को कहता है। 422 में फ़ील्ड सत्यापन या नीति संबंधी त्रुटियाँ होती हैं; 503 का अर्थ है कि आवश्यक सेवा उपलब्ध नहीं है।

401 प्रतिक्रिया · सटीक उदाहरण
{"message":"Bearer API key required."}