SNSNumber

ফোন নম্বর ভাড়া 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" } } প্রদান করে।

স্ট্যাটাসকোডঅর্থ
401no_key, bad_keyAPI কী অনুপস্থিত বা ভুল
402no_balanceপর্যাপ্ত ক্রেডিট নেই
404not_foundভাড়া নম্বর পাওয়া যায়নি
409ended, cancel_deniedভাড়া শেষ হয়েছে, বা বাতিল করার সময় উত্তীর্ণ হয়েছে
429rate_limited, too_many_activeপ্রতি মিনিটে 300 অনুরোধ, বা 20টি সক্রিয় নম্বর
503network_errorকিছুক্ষণ পরে আবার চেষ্টা করুন
ফোন নম্বর ভাড়া API: ভাড়া, ইনবক্স, এক্সটেন্ড | SNSNumber