ডেভেলপার API
বেস URL https://snsphone.com/api/v1। কনসোলের API পেজে একটি কী তৈরি করুন এবং এটি Authorization: Bearer spk_... হিসেবে পাঠান (অথবা একটি কী ফিল্ড)। সমস্ত নম্বর ইউনাইটেড স্টেটস নন-ভিওআইপি। অর্থ USD স্ট্রিং হিসেবে 2 দশমিক স্থান সহ, সময় ISO 8601 UTC, প্রতি কী প্রতি মিনিটে 300 রিকোয়েস্ট। 2026-11-03 পর্যন্ত দাম।
Python
import os, time, requests
API = "https://snsphone.com/api/v1"
H = {"Authorization": f"Bearer {os.environ['SNSPHONE_KEY']}"}
order = requests.post(f"{API}/orders", headers=H, data={"service": "google"}).json()["order"]
print("Use this US number:", order["phone"])
while True:
o = requests.get(f"{API}/orders/{order['id']}", headers=H).json()["order"]
if o["code"] or o["status"] in ("refunded", "canceled"):
break
time.sleep(4)
print("Code:", o["code"])Node.js
const API = "https://snsphone.com/api/v1";
const H = { Authorization: `Bearer ${process.env.SNSPHONE_KEY}` };
const { order } = await fetch(`${API}/orders`, {
method: "POST", headers: H, body: new URLSearchParams({ service: "discord" }),
}).then((r) => r.json());
console.log("Use this US number:", order.phone);
let o = order;
while (!o.code && !["refunded", "canceled"].includes(o.status)) {
await new Promise((r) => setTimeout(r, 4000));
({ order: o } = await fetch(`${API}/orders/${order.id}`, { headers: H }).then((r) => r.json()));
}
console.log("Code:", o.code);GET/services
প্রতিটি সার্ভিস কোড তার নাম, ক্যাটাগরি, ভেরিফিকেশন দাম এবং রেন্টাল পিরিয়ড সহ। কোন কী প্রয়োজন নেই।
পাবলিক, কোন কী প্রয়োজন নেই।
curl "https://snsphone.com/api/v1/services"
{"country":"us","services":[{"code":"whatsapp","name":"WhatsApp","category":"Messaging","verification":"0.90","rentals":[]},{"code":"telegram","name":"Telegram","verification":"0.45","rentals":[{"days":365,"period":"1 year","price":"37.44"}]}]}GET/prices?service=telegram
USD এ দাম, ঐচ্ছিকভাবে একটি সার্ভিসের জন্য। কোন কী প্রয়োজন নেই।
পাবলিক, কোন কী প্রয়োজন নেই।
curl "https://snsphone.com/api/v1/prices?service=telegram"
{"country":"us","prices":[{"service":"telegram","type":"verification","days":null,"price":"0.45"},{"service":"telegram","type":"rental","days":365,"price":"37.44"}]}GET/balance
আপনার ক্রেডিট USD এ।
আপনার API কী প্রয়োজন।
curl "https://snsphone.com/api/v1/balance" \ -H "Authorization: Bearer $KEY"
{"balance":"25.00","currency":"USD"}POST/orders
একটি ভেরিফিকেশন কিনুন (201)। ইউএস নম্বর এবং 20 মিনিট উইন্ডো শেষ হওয়ার সময় রিটার্ন করে।
আপনার API কী প্রয়োজন।
curl -X POST "https://snsphone.com/api/v1/orders" \ -H "Authorization: Bearer $KEY" \ -d "service=whatsapp"
{"order":{"id":"VR-7K2M9QX4PB","service":"whatsapp","country":"us","phone":"+14155550142","number":"4155550142","status":"waiting","code":null,"expires_at":"2026-11-03T12:20:00.000Z"},"window_minutes":20}GET/orders/VR-7K2M9QX4PB
একটি ভেরিফিকেশন তার স্ট্যাটাস এবং প্রাপ্ত প্রতিটি কোড সহ। স্ট্যাটাস: waiting, received, finished, refunded, canceled।
আপনার API কী প্রয়োজন।
curl "https://snsphone.com/api/v1/orders/VR-7K2M9QX4PB" \ -H "Authorization: Bearer $KEY"
{"order":{"id":"VR-7K2M9QX4PB","status":"received","code":"482913","sms":"Your WhatsApp code is 482913"}}GET/orders?status=open
আপনার ওপেন ভেরিফিকেশন (status=all শেষ 100 টির জন্য)।
আপনার API কী প্রয়োজন।
curl "https://snsphone.com/api/v1/orders?status=open" \ -H "Authorization: Bearer $KEY"
{"orders":[...]}POST/orders/VR-7K2M9QX4PB/resend
একই নম্বরে আরেকটি কোডের জন্য অনুরোধ করুন, প্রথম কোডের পরে এবং উইন্ডো খোলা থাকা অবস্থায়। কোন অতিরিক্ত চার্জ নেই।
আপনার API কী প্রয়োজন।
curl -X POST "https://snsphone.com/api/v1/orders/VR-7K2M9QX4PB/resend" \ -H "Authorization: Bearer $KEY"
{"order":{"status":"received","waiting_for_resend":true}}POST/orders/VR-7K2M9QX4PB/finish
একটি ভেরিফিকেশন বন্ধ করুন যেটি তার কোড পেয়েছে।
আপনার API কী প্রয়োজন।
curl -X POST "https://snsphone.com/api/v1/orders/VR-7K2M9QX4PB/finish" \ -H "Authorization: Bearer $KEY"
{"order":{"status":"finished"}}POST/orders/VR-7K2M9QX4PB/cancel
একটি কোড আসার আগে বাতিল করুন। সম্পূর্ণ দাম আপনার ক্রেডিটে ফেরত যাবে।
আপনার API কী প্রয়োজন।
curl -X POST "https://snsphone.com/api/v1/orders/VR-7K2M9QX4PB/cancel" \ -H "Authorization: Bearer $KEY"
{"order":{"status":"canceled","refunded":"0.90"}}POST/rentals
একটি সার্ভিস এবং পিরিয়ডের জন্য একটি ইউএস নম্বর ভাড়া নিন (201)। days ঐচ্ছিক যখন সার্ভিসের একটি পিরিয়ড থাকে।
আপনার API কী প্রয়োজন।
curl -X POST "https://snsphone.com/api/v1/rentals" \ -H "Authorization: Bearer $KEY" \ -d "service=telegram&days=365"
{"rental":{"id":"RN-4J8T2W6QHM","service":"telegram","phone":"+13125550198","days":365,"period":"1 year","price":"37.44","status":"active","ends_at":"2027-11-03T12:00:00.000Z","messages":[]}}GET/rentals?status=active
আপনার সক্রিয় রেন্টাল তাদের সর্বশেষ মেসেজ সহ (status=all শেষ 100 টির জন্য)।
আপনার API কী প্রয়োজন।
curl "https://snsphone.com/api/v1/rentals?status=active" \ -H "Authorization: Bearer $KEY"
{"rentals":[...]}GET/rentals/RN-4J8T2W6QHM
একটি রেন্টাল তার প্রাপ্ত প্রতিটি এসএমএস সহ।
আপনার API কী প্রয়োজন।
curl "https://snsphone.com/api/v1/rentals/RN-4J8T2W6QHM" \ -H "Authorization: Bearer $KEY"
{"rental":{"id":"RN-4J8T2W6QHM","status":"active","messages":[{"from":"Telegram","sms":"Telegram code: 57291","code":"57291","received_at":"2026-11-03T12:01:12.000Z"}]}}POST/rentals/RN-4J8T2W6QHM/renew
একই দামে আরেকটি পিরিয়ড যোগ করুন।
আপনার API কী প্রয়োজন।
curl -X POST "https://snsphone.com/api/v1/rentals/RN-4J8T2W6QHM/renew" \ -H "Authorization: Bearer $KEY"
{"rental":{"renewed":1,"ends_at":"2028-11-02T12:00:00.000Z"}}POST/rentals/RN-4J8T2W6QHM/cancel
প্রথম 20 মিনিটে বাতিল করুন যখন কোন এসএমএস আসেনি। প্রদত্ত সমস্ত অর্থ আপনার ক্রেডিটে ফেরত যাবে।
আপনার API কী প্রয়োজন।
curl -X POST "https://snsphone.com/api/v1/rentals/RN-4J8T2W6QHM/cancel" \ -H "Authorization: Bearer $KEY"
{"rental":{"status":"canceled","refunded":"37.44"}}যেসব টুলস ইতিমধ্যে সাধারণ অ্যাক্টিভেশন ফরম্যাট বোঝে তাদের জন্য। একটি URL, একটি অ্যাকশন ফিল্ড, প্লেইন টেক্সট উত্তর। শুধুমাত্র ভেরিফিকেশন।
https://snsphone.com/stubs/handler_api.php?api_key=KEY&action=ACTION
| অ্যাকশন | অতিরিক্ত ফিল্ড | উত্তর | অর্থ |
|---|---|---|---|
| getBalance | কিছু নেই | ACCESS_BALANCE:12.50 | আপনার ক্রেডিট USD এ। |
| getServicesList | কিছু নেই | {"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]} | একটি ভেরিফিকেশন দাম সহ সার্ভিস কোড (JSON)। |
| getCountries | কিছু নেই | {"us":{"name":"United States","dial":"1"}} | শুধুমাত্র ইউনাইটেড স্টেটস। country হতে পারে us, 187 বা ফাঁকা রাখা। |
| getPrices | &service=whatsapp | {"us":{"whatsapp":{"cost":0.9,"count":100}}} | USD এ দাম। সার্ভিস ফিল্টার ঐচ্ছিক। |
| getNumber | &service=whatsapp&country=us | ACCESS_NUMBER:VR-7K2M9QX4PB:14155550142 | একটি ভেরিফিকেশন কিনুন। id এবং 1 দিয়ে শুরু হওয়া নম্বর রিটার্ন করে। |
| getStatus | &id=VR-7K2M9QX4PB | STATUS_OK:482913 | STATUS_WAIT_CODE, STATUS_OK:<code>, STATUS_WAIT_RETRY:<last code> (আরেকটি কোড চাওয়া হয়েছে), STATUS_CANCEL (বাতিল বা রিফান্ড করা হয়েছে)। |
| setStatus | &id=VR-7K2M9QX4PB&status=3 | ACCESS_RETRY_GET | status=1 রেডি (ACCESS_READY), 3 আরেকটি কোড (ACCESS_RETRY_GET), 6 ফিনিশ (ACCESS_ACTIVATION), 8 কোন কোড না আসা অবস্থায় সম্পূর্ণ রিফান্ড সহ বাতিল (ACCESS_CANCEL)। |
REST এরর {"error":{"code","message"}} সহ এই স্ট্যাটাস কোড দিয়ে আসে। অ্যাক্টিভেশন ফরম্যাট একটি প্লেইন শব্দ দিয়ে উত্তর দেয়।
| 400 | অনুপস্থিত বা ভুল ফিল্ড (bad_json, bad_period)। |
| 401 | কোন কী নেই বা ভুল কী (no_key, bad_key)। |
| 402 | পর্যাপ্ত ক্রেডিট নেই (no_balance)। |
| 404 | অজানা সার্ভিস, অর্ডার, ভাড়া বা এন্ডপয়েন্ট, অথবা এমন পণ্য যা সার্ভিসে নেই (not_sold)। |
| 409 | এখন সম্ভব নয় (has_code, has_sms, too_late, not_ready, too_many_open, too_many_active, no_numbers)। |
| 429 | এক মিনিটে 300 এর বেশি অনুরোধ (rate_limited)। |
| BAD_KEY | অনুপস্থিত বা ভুল API কী। |
| BAD_ACTION | অজানা অ্যাকশন। |
| BAD_SERVICE | অজানা সার্ভিস কোড। |
| BAD_COUNTRY | যুক্তরাষ্ট্র নয়, অথবা সার্ভিসটি শুধুমাত্র ভাড়া হিসেবে বিক্রি হয়। |
| NO_BALANCE | পর্যাপ্ত ক্রেডিট নেই। |
| NO_NUMBERS | এখন কোন নম্বর ফ্রি নেই। কিছুক্ষণ পর আবার চেষ্টা করুন। |
| NO_ACTIVATION | অজানা আইডি, অথবা আপনার নয়। |
| EARLY_CANCEL_DENIED | ইতিমধ্যে একটি কোড এসে গেছে, তাই এটি বাতিল করা যাবে না। |
| NO_ACTIVATIONS | ইতিমধ্যে 20টি ভেরিফিকেশন খোলা আছে। |
| TOO_MANY_REQUESTS | এক মিনিটে 300 এর বেশি অনুরোধ। |
কী, সীমা এবং পোলিং সম্পর্কে উত্তর।
হ্যাঁ। একটি REST API যেখানে JSON ফরম্যাটে /api/v1 এ সার্ভিস, মূল্য, ভেরিফিকেশন এবং ভাড়া, এবং সাধারণ এসএমএস অ্যাক্টিভেশন ফরম্যাট /stubs/handler_api.php এ পাওয়া যায়।
কনসোলের API পৃষ্ঠায় একটি কী তৈরি করুন এবং Authorization: Bearer spk_... হিসাবে পাঠান, অথবা একটি কী ফিল্ড হিসাবে। কীগুলি শুধুমাত্র হ্যাশ হিসাবে সংরক্ষণ করা হয় এবং একবার দেখানো হয়।
প্রতি কী প্রতি মিনিটে 300 অনুরোধ, প্রতি অ্যাকাউন্টে সর্বাধিক 20টি খোলা ভেরিফিকেশন এবং 20টি সক্রিয় ভাড়া।
না। API একই মূল্য এবং একই রিফান্ড নিয়ম ব্যবহার করে যেমন কনসোলে আছে।
কয়েক সেকেন্ড পরপর GET /orders/{id} পোল করুন। স্ট্যাটাস waiting থেকে received এ পরিবর্তিত হবে এবং code ফিল্ডে ডিজিটগুলি থাকবে।