Bearer कुंजी और अधिकार
हर अनुरोध में Authorization हेडर दें। गुम या रद्द कुंजी पर 401 और आवश्यक अधिकार के बिना कुंजी पर 403 मिलता है। API कुंजी केवल बनते समय पूरी दिखाई जाती है।
Authorization: Bearer YOUR_API_KEYअपने खाते की सीमित अधिकार वाली API कुंजी इस्तेमाल करें। अनुरोध Bearer प्रमाणीकरण इस्तेमाल करते हैं और JSON लौटाते हैं। पहले मार्केटप्लेस देखें, फिर स्वीकृत ID से ट्रैफ़िक भेजें।
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.
हर अनुरोध में Authorization हेडर दें। गुम या रद्द कुंजी पर 401 और आवश्यक अधिकार के बिना कुंजी पर 403 मिलता है। API कुंजी केवल बनते समय पूरी दिखाई जाती है।
Authorization: Bearer YOUR_API_KEYआवश्यक है marketplace:read। गंतव्य, ऑपरेटर और 1h, 24h or 7d समय अवधि से फ़िल्टर करें। ग्राहक प्रतिक्रियाओं में कैरियर पहचान के बिना रूट उपनाम और ग्राहक मूल्य होते हैं।
GET /api/v1/marketplace?destination=India&operator=Airtel&window=24h{
"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
}आवश्यक है 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.
{
"idempotency_key": "11111111-1111-4111-8111-111111111111",
"to": ["+919812345670"],
"message": "Your code is 448120",
"sender_id": "SKYOTP",
"route": "auto",
"destination": "India",
"operator": "Airtel"
}{
"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."
}आवश्यक है 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.
{
"to": "+442079460102",
"caller_id": "+15550001111"
}{
"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 का अर्थ है कि आवश्यक सेवा उपलब्ध नहीं है।
{"message":"Bearer API key required."}