फोन नंबर किराए पर लेने का API

अपने कोड से नंबर किराए पर लें, आने वाले SMS पढ़ें, एक्सटेंड और रद्द करें। HTTPS पर JSON जो कंसोल से एक API कुंजी के साथ होता है।

बेस URL: https://snsnumber.com/api/v1
प्रमाणीकरण: Authorization: Bearer snk_...
दर सीमा: प्रति कुंजी प्रति मिनट 300 अनुरोध

API के तहत कंसोल में कुंजी बनाएं। कीमतें अमेरिकी डॉलर में दो दशमलव के साथ स्ट्रिंग के रूप में होती हैं। समय UTC में ISO 8601 होते हैं।

एंडपॉइंट्स

GET/balanceअमेरिकी डॉलर में आपका क्रेडिट।

{ "balance": "120.00", "currency": "USD" }

GET/prices?country=usदेश, अवधि और कीमतें। सभी के लिए देश छोड़ दें।

{ "currency": "USD", "countries": [ { "country": "us", "name": "United States", "dial": "+1",
  "periods": [ { "days": 15, "price": "36.00" }, { "days": 30, "price": "54.00" } ] } ] }

POST/rentalsएक नंबर किराए पर लें। बॉडी: देश और दिन।

curl -X POST https://snsnumber.com/api/v1/rentals -H "Authorization: Bearer snk_..." \
  -H "Content-Type: application/json" -d '{"country":"us","days":30}'

{ "rental": { "id": "RN-7KQ2M9XWD4", "country": "us", "phone": "+14155550123", "state": "active",
  "days": 30, "ends_at": "2026-12-03T10:00:00.000Z", "can_cancel": true, "messages": [] } }

GET/rentals?state=activeआपकी किराए पर ली गई संख्याएँ, नवीनतम पहले (स्थिति: सक्रिय, समाप्त, रद्द)।

{ "rentals": [ { "id": "RN-7KQ2M9XWD4", "phone": "+14155550123", "state": "active", "message_count": 2 } ] }

GET/rentals/{id}एक किराए पर ली गई संख्या और उसका इनबॉक्स।

{ "rental": { "id": "RN-7KQ2M9XWD4", "messages": [ { "id": 18, "sender": "Verify",
  "text": "Your verification code is 482913.", "code": "482913", "received_at": "2026-11-03T10:01:12.000Z" } ] } }

POST/rentals/{id}/extendएक सक्रिय किराए पर ली गई संख्या में अवधि जोड़ें। बॉडी: दिन।

{"days":15}  ->  { "rental": { "id": "RN-7KQ2M9XWD4", "extensions": 1, "ends_at": "2026-12-18T10:00:00.000Z" } }

POST/rentals/{id}/cancel20 मिनट के भीतर पूर्ण धनवापसी जब तक कोई एसएमएस नहीं आया है।

{ "rental": { "id": "RN-7KQ2M9XWD4", "state": "canceled" } }

त्रुटियाँ

त्रुटियाँ एक HTTP स्थिति और { "error": { "code", "message" } } लौटाती हैं।

स्थिति	कोड	अर्थ
401	no_key, bad_key	API कुंजी गायब या गलत
402	no_balance	पर्याप्त क्रेडिट नहीं
404	not_found	किराया नहीं मिला
409	ended, cancel_denied	किराया समाप्त हो गया, या रद्द करने की विंडो बीत चुकी है
429	rate_limited, too_many_active	प्रति मिनट 300 अनुरोध, या 20 सक्रिय संख्याएँ
503	network_error	कुछ देर बाद पुनः प्रयास करें