handler_api متوافق مع sms-activate: الأوامر والحالات ورموز الدول والخدمات نفسها، مع webhook للرموز.
رابط handler_api
https://allinsms.com/stubs/handler_api.php
عنوان REST API الأساسي
https://allinsms.com/api/v1
طلب GET أو POST مع api_key وaction. تستخدم الدول المعرّفات الرقمية القياسية (getCountries) والخدمات الرموز القياسية (tg، wa، go …). الردود نص عادي ما لم يُذكر خلاف ذلك.
GET https://allinsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=6| action | المعاملات | الرد | الوصف |
|---|---|---|---|
| getBalance | لا شيء | ACCESS_BALANCE:12.3400 | الرصيد الحالي بالدولار USD. |
| getNumber | service, country, maxPrice? | ACCESS_NUMBER:1042:6281244739021 | شراء رقم. يُخصم فورًا ويُسترد إذا لم يصل رمز. |
| getNumberV2 | service, country, maxPrice? | {"activationId":1042,"phoneNumber":"628…","activationCost":"0.7800",…} | مثل getNumber، مع رد JSON يتضمن السعر ووقت الانتهاء. |
| getStatus | id | STATUS_WAIT_CODE · STATUS_OK:48213 · STATUS_WAIT_RETRY:48213 · STATUS_CANCEL | استعلم كل 3 إلى 5 ثوانٍ حتى يصل رمز. |
| getStatusV2 | id | {"verificationType":0,"sms":{"code":"48213","text":"…"},"call":null} | حالة JSON مع نص SMS كاملًا. |
| getFullSms | id | FULL_SMS:Your code is 48213 | النص الكامل لآخر رسالة SMS. |
| setStatus | id, status=1|3|6|8 | ACCESS_READY · ACCESS_RETRY_GET · ACCESS_ACTIVATION · ACCESS_CANCEL | 1 جاهز، 3 رمز آخر، 6 إنهاء، 8 إلغاء (بعد مدة الانتظار وقبل وصول رمز). |
| getActiveActivations | لا شيء | {"status":"success","activeActivations":[…]} | أرقامك التي لا تزال نشطة. |
| getPrices | service?, country? | {"6":{"tg":{"cost":"0.7800","count":5320}}} | السعر والمخزون حسب الدولة والخدمة. |
| getNumbersStatus | country? | {"tg_0":"5320","wa_0":"812",…} | المخزون لكل خدمة في دولة ما. |
| getCountries | لا شيء | {"6":{"id":6,"eng":"Indonesia","iso":"id","phoneCode":"62",…}} | قائمة الدول مع المعرّفات. |
| getServicesList | لا شيء | {"status":"success","services":[{"code":"tg","name":"Telegram"}]} | رموز الخدمات وأسماؤها. |
قيم setStatus
التوقيت
تبقى الأرقام نشطة 20 دقيقة افتراضيًا. يُقبل الإلغاء بعد 120 ثانية من الشراء (قبل ذلك يُرجع EARLY_CANCEL_DENIED). إذا لم يصل رمز يُسترد التفعيل تلقائيًا عند انتهائه. حد الطلبات: 300 طلب في الدقيقة لكل مفتاح.
عيّن رابط webhook في صفحة الحساب وسنرسل إليه كل رمز مستلم بصيغة JSON عبر POST، مع إعادة المحاولة مرتين إذا لم يرد خادمك بـ 2xx.
POST https://your-server/webhook
{ "activationId": 1042, "service": "tg", "country": "id", "phone": "6281244739021",
"code": "48213", "text": "Telegram code: 48213 …", "receivedAt": "2026-10-09T03:12:44.000Z" }يُنشأ داخل متصفحك. نحتفظ ببصمته فقط.