انتقل إلى المحتوى
tomnumber

API التحقق عبر SMS

اشترِ الأرقام واقرأ الرموز من برنامجك الخاص. يستخدم الـ API رصيدك، والأسعار نفسها، وقاعدة الاسترداد بعد 20 دقيقة نفسها المعمول بها في الموقع.

تنشئ مفتاح API داخل حسابك. الأرقام المشتراة عبر الـ API تُخصم من الرصيد نفسه وبالأسعار نفسها كما في الموقع.

إنشاء حسابمفتاح API

من $0.0018 للرقم الواحد

معلومات أساسية

أقل سعر للرقم الواحد
$0.0018
المصادقة
مفتاح API
الصيغة
JSON عبر HTTPS
حد الطلبات
120 طلب في الدقيقة
الاسترداد
كما في الموقع

REST وJSON

ستة طلبات تغطي الرصيد، والخدمات، والأسعار، والحصول على رقم، والحالة، والإلغاء.

مفتاح من حسابك

أنشئ مفتاحًا في صفحة مفتاح API في حسابك وأرسله في ترويسة Authorization.

أسعار الموقع نفسها

أسعار الأرقام وقاعدة الاسترداد بعد 20 دقيقة هي نفسها كما في الموقع.

ما الطلبات التي أستطيع إرسالها؟

تأتي المسارات بعد عنوان URL الأساسي. كل طلب يحتاج مفتاح API الخاص بك.

ما الطلبات التي أستطيع إرسالها؟
الطريقة والمسارالوظيفة
GET/balanceرصيدك بالدولار (USD)
GET/servicesكل الخدمات مع أقل سعر وعدد الدول
GET/prices?service=telegramسعر الرقم الواحد في كل دولة لخدمة معينة
POST/numbersالحصول على رقم لخدمة ودولة، ويُخصم السعر من رصيدك
GET/numbers/{id}حالة الرقم وكل الرموز المستلمة حتى الآن
POST/numbers/{id}/cancelالإلغاء قبل وصول رمز، ويعود السعر إلى رصيدك

بأي ترتيب أستدعي الـ API؟

  1. 1

    احصل على رقم POST /numbers مع service وcountry. احفظ id والرقم.

  2. 2

    أدخل الرقم اكتب الرقم في الخدمة التي ترسل الرمز.

  3. 3

    تحقق من وصول الرمز GET /numbers/{id} كل 5 ثوانٍ حتى لا تكون قائمة codes فارغة.

  4. 4

    أنهِ العملية استخدم الرمز. إذا لم تعد تحتاج الرقم قبل وصول رمز، فألغِه.

كيف أحصل على مفتاح API؟

سجّل الدخول وافتح مفتاح API في حسابك. أنشئ مفتاحًا وانسخه فورًا، فهو يظهر مرة واحدة فقط. إنشاء مفتاح جديد يوقف المفتاح القديم.

مفتاح API

ما عنوان URL الأساسي؟

أرسل كل طلب إلى هذا العنوان مع المفتاح في ترويسة Authorization (Bearer) أو ترويسة X-Api-Key:

https://tomnumber.com/api/v1
Authorization: Bearer <API_KEY>

حقول الطلب

حقول الطلب
الحقليُستخدم فيالقيمة
servicePOST /numbers, GET /pricesاسم الخدمة من /services، مثل telegram
countryPOST /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"

أسئلة شائعة عن API التحقق عبر SMS

ما هو API التحقق عبر SMS؟

طريقة لشراء الأرقام وقراءة الرموز من برنامجك الخاص بدلًا من الموقع.

هل للـ API تكلفة إضافية؟

لا. الأرقام بالسعر نفسه كما في الموقع وتُدفع من الرصيد نفسه.

كم طلبًا أستطيع إرساله؟

حتى 120 طلب في الدقيقة لكل مفتاح. الاستعلام كل 5 ثوانٍ يبقى ضمن هذا الحد بكثير.

هل يُسترد مبلغ أرقام الـ API أيضًا؟

نعم، بالقاعدة نفسها: إذا لم يصل رمز خلال 20 دقيقة يعود السعر إلى رصيدك.

أين أنشئ المفتاح؟

في حسابك ضمن قسم مفتاح API.

أرقام افتراضية لخدمات أخرى