- الرئيسية
- API
API التحقق عبر SMS
اشترِ الأرقام واقرأ الرموز من برنامجك الخاص. يستخدم الـ API رصيدك، والأسعار نفسها، وقاعدة الاسترداد بعد 20 دقيقة نفسها المعمول بها في الموقع.
تنشئ مفتاح API داخل حسابك. الأرقام المشتراة عبر الـ API تُخصم من الرصيد نفسه وبالأسعار نفسها كما في الموقع.
معلومات أساسية
- أقل سعر للرقم الواحد
- $0.0018
- المصادقة
- مفتاح API
- الصيغة
- JSON عبر HTTPS
- حد الطلبات
- 120 طلب في الدقيقة
- الاسترداد
- كما في الموقع
REST وJSON
ستة طلبات تغطي الرصيد، والخدمات، والأسعار، والحصول على رقم، والحالة، والإلغاء.
مفتاح من حسابك
أنشئ مفتاحًا في صفحة مفتاح API في حسابك وأرسله في ترويسة Authorization.
أسعار الموقع نفسها
أسعار الأرقام وقاعدة الاسترداد بعد 20 دقيقة هي نفسها كما في الموقع.
ما الطلبات التي أستطيع إرسالها؟
تأتي المسارات بعد عنوان URL الأساسي. كل طلب يحتاج مفتاح API الخاص بك.
| الطريقة والمسار | الوظيفة |
|---|---|
GET/ | رصيدك بالدولار (USD) |
GET/ | كل الخدمات مع أقل سعر وعدد الدول |
GET/ | سعر الرقم الواحد في كل دولة لخدمة معينة |
POST/ | الحصول على رقم لخدمة ودولة، ويُخصم السعر من رصيدك |
GET/ | حالة الرقم وكل الرموز المستلمة حتى الآن |
POST/ | الإلغاء قبل وصول رمز، ويعود السعر إلى رصيدك |
بأي ترتيب أستدعي الـ API؟
- 1
احصل على رقم POST /numbers مع service وcountry. احفظ id والرقم.
- 2
أدخل الرقم اكتب الرقم في الخدمة التي ترسل الرمز.
- 3
تحقق من وصول الرمز GET /numbers/{id} كل 5 ثوانٍ حتى لا تكون قائمة codes فارغة.
- 4
أنهِ العملية استخدم الرمز. إذا لم تعد تحتاج الرقم قبل وصول رمز، فألغِه.
كيف أحصل على مفتاح API؟
سجّل الدخول وافتح مفتاح API في حسابك. أنشئ مفتاحًا وانسخه فورًا، فهو يظهر مرة واحدة فقط. إنشاء مفتاح جديد يوقف المفتاح القديم.
مفتاح APIما عنوان URL الأساسي؟
أرسل كل طلب إلى هذا العنوان مع المفتاح في ترويسة Authorization (Bearer) أو ترويسة X-Api-Key:
https://tomnumber.com/api/v1Authorization: Bearer <API_KEY>حقول الطلب
| الحقل | يُستخدم في | القيمة |
|---|---|---|
service | POST /numbers, GET /prices | اسم الخدمة من /services، مثل telegram |
country | POST /numbers | رمز الدولة من حرفين، مثل gb |
حقول الاستجابة والحالات
| القيمة | المعنى |
|---|---|
waiting | الرقم مفتوح ولم يصل أي رمز بعد |
received | وصل رمز واحد على الأقل، وقد تصل رموز أخرى حتى expires_at |
refunded | لم يصل رمز خلال 20 دقيقة، وعاد السعر إلى رصيدك |
canceled | ألغيت الرقم قبل وصول رمز، وعاد السعر إلى رصيدك |
مثال على الاستجابة
{ "ok": true, "id": "R8KQ2M7XWD4P", "service": "telegram", "country": "gb", "number": "+44 7700 900412", "price": "0.167", "status": "received", "expires_at": "2026-11-11T09:20:00.000Z", "codes": [ { "code": "483920", "text": "Telegram code: 483920", "received_at": "2026-11-11T09:01:12.000Z" } ]}رموز الأخطاء
unauthorized | مفتاح API مفقود أو غير صحيح |
rate_limited | أكثر من 120 طلب في الدقيقة |
bad_service | اسم خدمة غير معروف |
bad_country | الدولة غير متاحة لهذه الخدمة |
low_balance | الرصيد أقل من السعر |
unavailable | لا يوجد رقم متاح الآن. لم يُخصم أي مبلغ |
not_found | لا يوجد رقم بهذا المعرّف في حسابك |
cannot_cancel | وصل رمز بالفعل أو أن الرقم مغلق |
أمثلة برمجية
# get a numbercurl -X POST https://tomnumber.com/api/v1/numbers \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{"service":"telegram","country":"gb"}' # check for codescurl https://tomnumber.com/api/v1/numbers/R8KQ2M7XWD4P \ -H "Authorization: Bearer $API_KEY"const api = (path, init = {}) => fetch("https://tomnumber.com/api/v1" + path, { ...init, headers: { Authorization: "Bearer " + process.env.API_KEY, "Content-Type": "application/json" }, }).then((r) => r.json()); const n = await api("/numbers", { method: "POST", body: JSON.stringify({ service: "telegram", country: "gb" }) });console.log(n.number); // enter this number in the app let codes = [];while (!codes.length) { await new Promise((r) => setTimeout(r, 5000)); const s = await api("/numbers/" + n.id); if (s.status === "refunded" || s.status === "canceled") break; codes = s.codes;}console.log(codes.map((c) => c.code));import os, time, requests API = "https://tomnumber.com/api/v1"H = {"Authorization": "Bearer " + os.environ["API_KEY"]} n = requests.post(API + "/numbers", json={"service": "telegram", "country": "gb"}, headers=H).json()print(n["number"]) # enter this number in the app while True: time.sleep(5) s = requests.get(API + "/numbers/" + n["id"], headers=H).json() if s["codes"] or s["status"] in ("refunded", "canceled"): breakprint([c["code"] for c in s["codes"]])أسئلة شائعة عن API التحقق عبر SMS
ما هو API التحقق عبر SMS؟
طريقة لشراء الأرقام وقراءة الرموز من برنامجك الخاص بدلًا من الموقع.
هل للـ API تكلفة إضافية؟
لا. الأرقام بالسعر نفسه كما في الموقع وتُدفع من الرصيد نفسه.
كم طلبًا أستطيع إرساله؟
حتى 120 طلب في الدقيقة لكل مفتاح. الاستعلام كل 5 ثوانٍ يبقى ضمن هذا الحد بكثير.
هل يُسترد مبلغ أرقام الـ API أيضًا؟
نعم، بالقاعدة نفسها: إذا لم يصل رمز خلال 20 دقيقة يعود السعر إلى رصيدك.
أين أنشئ المفتاح؟
في حسابك ضمن قسم مفتاح API.