ফোন নম্বর ভাড়া API
আপনার নিজস্ব কোড থেকে নম্বর ভাড়া নিন, আগত এসএমএস পড়ুন, এক্সটেন্ড এবং বাতিল করুন। কনসোল থেকে একটি API কী সহ HTTPS এর উপর JSON।
- বেস URL
- https://snsnumber.com/api/v1
- প্রমাণীকরণ
- Authorization: Bearer snk_...
- রেট লিমিট
- প্রতি কী প্রতি মিনিটে 300 অনুরোধ
API এর অধীনে কনসোলে কী তৈরি করুন। মূল্য দুই দশমিক সহ US ডলারে স্ট্রিং হিসাবে। সময়গুলি UTC তে ISO 8601।
এন্ডপয়েন্ট
GET
/balanceUS ডলারে আপনার ক্রেডিট।{ "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 | কিছুক্ষণ পরে আবার চেষ্টা করুন |