বেস URL https://snsverify.com/api/v1
এই পৃষ্ঠার প্রতিটি পথ এর সাথে সম্পর্কিত। পরিমাণগুলি ইউএস ডলারে স্ট্রিং হিসাবে দুই দশমিক সহ, সময়গুলি UTC (ISO 8601)।
দুই ফরম্যাট, এক অ্যাকাউন্ট
এই পৃষ্ঠাটি JSON সহ REST API বর্ণনা করে। যদি আপনার টুলটি ইতিমধ্যেই সাধারণ এসএমএস অ্যাক্টিভেশন ফরম্যাট (handler_api.php with action= প্যারামিটার) ব্যবহার করে, তাহলে এসএমএস অ্যাক্টিভেশন API ব্যবহার করুন। উভয়ই আপনার API কী, মূল্য, খোলা অ্যাক্টিভেশন এবং ফেরত শেয়ার করে।
সংক্ষিপ্ত বিবরণ
একটি এসএমএস ভেরিফিকেশন API আপনার নিজের সফটওয়্যারকে একটি অ্যাপের জন্য একটি ফোন নম্বর কিনতে, ভেরিফিকেশন এসএমএসের জন্য অপেক্ষা করতে এবং কোডটি পড়তে দেয়, ওয়েবসাইট খোলা ছাড়াই। প্রতিটি অর্ডার একটি অ্যাক্টিভেশন: একটি সার্ভিস, একটি দেশ, একটি নম্বর এবং একটি 20 মিনিটের উইন্ডো। কোড ছাড়া অর্ডারগুলি উইন্ডোর শেষে সম্পূর্ণ মূল্য ফেরত দেওয়া হয়।
অনুরোধগুলি পড়ার জন্য GET এবং কর্মের জন্য POST ব্যবহার করে। POST বডি ফর্ম ফিল্ড বা JSON হতে পারে। সফল উত্তরগুলি JSON অবজেক্ট; ত্রুটিগুলি সর্বত্র একই আকারে থাকে: {"error":{"code":"...","message":"..."}}.
প্রমাণীকরণ
কনসোলের অধীনে API কী তৈরি করুন। এটি একবার দেখানো হয়; আমরা শুধুমাত্র একটি স্ক্র্যাম্বলড কপি রাখি। এটিকে Authorization হেডারে একটি bearer টোকেন হিসাবে পাঠান। একটি কী প্যারামিটারও সেই টুলগুলির জন্য গ্রহণযোগ্য যা হেডার সেট করতে পারে না।
Authorization: Bearer vfk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
একটি নতুন কী তৈরি করা পুরানোটিকে সাথে সাথে প্রতিস্থাপন করে। সার্ভিস, দেশ এবং মূল্য এন্ডপয়েন্টগুলি কী ছাড়াই কাজ করে।
ত্রুটিসমূহ
| HTTP | অর্থ |
|---|---|
| 400 | হারানো বা খারাপ ফিল্ড (missing_filter, bad_json)। |
| 401 | কোন কী বা ভুল কী (no_key, bad_key)। |
| 402 | পর্যাপ্ত ক্রেডিট নেই (no_balance)। |
| 404 | অজানা সার্ভিস, দেশ, অর্ডার বা এন্ডপয়েন্ট। |
| 409 | অর্ডারটি এখন তা করতে পারে না (has_code, not_ready, too_many_open, no_numbers)। |
| 429 | এক মিনিটে 300 টির বেশি অনুরোধ (rate_limited)। |
দ্রুত শুরু
curl দিয়ে একটি UK WhatsApp নম্বর অর্ডার করুন, তারপর কোড আসা পর্যন্ত প্রতি কয়েক সেকেন্ডে অর্ডারটি পোল করুন।
curl -X POST https://snsverify.com/api/v1/orders \ -H "Authorization: Bearer $SNSVERIFY_KEY" \ -d service=whatsapp -d country=gb
Python
import os, time, requests
API = "https://snsverify.com/api/v1"
H = {"Authorization": f"Bearer {os.environ['SNSVERIFY_KEY']}"}
order = requests.post(f"{API}/orders", headers=H,
data={"service": "whatsapp", "country": "gb"}).json()["order"]
print("Use this 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://snsverify.com/api/v1";
const H = { Authorization: `Bearer ${process.env.SNSVERIFY_KEY}` };
const { order } = await fetch(`${API}/orders`, {
method: "POST", headers: H,
body: new URLSearchParams({ service: "telegram", country: "nl" }),
}).then((r) => r.json());
console.log("Use this 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);হার সীমা
প্রতি কী প্রতি মিনিটে 300 অনুরোধ, এবং প্রতি অ্যাকাউন্টে 20 টি পর্যন্ত খোলা অর্ডার। প্রতি 3 থেকে 5 সেকেন্ডে একটি অর্ডার পোল করা যথেষ্ট: বেশিরভাগ কোড এক মিনিটের মধ্যে আসে।
অর্ডার অবস্থা
waitingনম্বরটি খোলা এবং এখনো কোন কোড আসেনি।receivedঅন্তত একটি কোড এসেছে; উইন্ডো খোলা থাকাকালীন resend দিয়ে আরেকটি কোড চাইতে পারেন।finishedকোডের পরে বন্ধ, আপনার দ্বারা বা উইন্ডোর শেষে।refundedউইন্ডোটি কোন কোড ছাড়াই শেষ হয়েছে; সম্পূর্ণ মূল্য আপনার ক্রেডিটে ফিরে গেছে।canceledকোড আসার আগে আপনি বাতিল করেছেন; সম্পূর্ণ মূল্য আপনার ক্রেডিটে ফিরে গেছে।
এন্ডপয়েন্টস
GET/services
প্রতিটি সার্ভিস কোড এর নাম, বিভাগ এবং সর্বনিম্ন মূল্য সহ। কোন কী প্রয়োজন নেই।
{"services":[{"code":"whatsapp","name":"WhatsApp","category":"social","from":"0.31"}]}GET/countries
প্রতিটি দেশ কোড (ISO, লোয়ার কেস) নাম এবং ডায়াল কোড সহ। কোন কী প্রয়োজন নেই।
{"countries":[{"code":"gb","name":"United Kingdom","dial_code":"44"}]}GET/prices?service=whatsapp&country=gb
USD এ মূল্য। সার্ভিস, দেশ বা উভয় দ্বারা ফিল্টার করুন। কোন কী প্রয়োজন নেই।
{"prices":[{"service":"whatsapp","country":"gb","price":"0.94"}]}GET/balance
USD এ আপনার ক্রেডিট।
{"balance":"25.00","currency":"USD"}POST/orders
একটি নম্বর কেনে (HTTP 201)। ফোন নম্বর এবং উইন্ডো শেষ হওয়ার সময় সহ অর্ডারটি ফেরত দেয়।
বডি: service=whatsapp&country=gb
{"order":{"id":"AC-7K2M9QX4PB","service":"whatsapp","country":"gb","phone":"+447700900123","price":"0.94","status":"waiting","code":null,"expires_at":"2026-11-04T12:20:00.000Z"},"window_minutes":20}GET/orders/AC-7K2M9QX4PB
একটি অর্ডার এর অবস্থা এবং প্রাপ্ত প্রতিটি কোড সহ। অবস্থা: waiting, received, finished, refunded, canceled।
{"order":{"id":"AC-7K2M9QX4PB","status":"received","code":"482915","sms":"Your WhatsApp code: 482-915"}}GET/orders?status=open
আপনার খোলা অর্ডার; status=all শেষ 100 টি ফেরত দেয়।
{"orders":[{"id":"AC-7K2M9QX4PB","status":"waiting"}]}POST/orders/AC-7K2M9QX4PB/resend
প্রথম কোডের পরে একই নম্বরে আরেকটি কোড চাইতে পারেন, উইন্ডো খোলা থাকাকালীন। কোন অতিরিক্ত চার্জ নেই।
{"order":{"status":"received","waiting_for_resend":true}}POST/orders/AC-7K2M9QX4PB/finish
একটি অর্ডার বন্ধ করে যা এর কোড পেয়েছে।
{"order":{"status":"finished"}}POST/orders/AC-7K2M9QX4PB/cancel
কোড আসার আগে বাতিল করে। সম্পূর্ণ মূল্য আপনার ক্রেডিটে ফিরে যায়।
{"order":{"status":"canceled","refunded":"0.94"}}