اختيار اللغة

نقطة النهاية المتوافقة مع sms-activate

واصل استخدام الروبوتات ولوحات التحكم المصممة لبروتوكول sms-activate بتغيير عنوان URL واحد. الإجراءات المدعومة وصيغ المعرّفات والفروق التي يجب معرفتها.

في هذه الصفحة
  1. نقطة النهاية
  2. مثال
  3. الإجراءات المدعومة
  4. المعرّفات
  5. فروق يجب معرفتها

كثير من الأدوات تستخدم بروتوكول sms-activate. يوفّر SmsGrab نقطة نهاية متوافقة، لذا تعمل هذه الأدوات بمجرد تغيير عنوان URL الأساسي واستخدام مفتاح API الخاص بك في SmsGrab.

نقطة النهاية

نص
https://smsgrab.com/api/stubs/handler_api.php

أرسل api_key وaction مع معاملات الإجراء، عبر GET أو POST. يمكن إرسال المفتاح أيضًا كـ Authorization: Bearer.

مثال

Bash
curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getBalance"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getNumber&service=tg&country=6"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getStatus&id=100000123"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=setStatus&id=100000123&status=6"
نص
ACCESS_BALANCE:12.34
ACCESS_NUMBER:100000123:6281234567890
STATUS_WAIT_CODE
STATUS_OK:482913
ACCESS_ACTIVATION

الإجراءات المدعومة

الإجراء ما يفعله
getBalance، getBalanceAndCashBack رصيدك
getNumber، getNumberV2 شراء رقم
setStatus 1 جاهز، 3 انتظار رسالة أخرى، 6 إنهاء، 8 إلغاء واسترداد
getStatus، getStatusV2 انتظار أو وصول رمز أو إلغاء
getActiveActivations الأرقام التي لا تزال نشطة
getPrices، getTopCountriesByService، getNumbersStatus الأسعار والمخزون
getCountries، getServicesList الدول والخدمات مع معرّفاتها

المعرّفات

  • الخدمات تستخدم الرموز القصيرة للبروتوكول حيثما وُجدت، مثل wa لـ WhatsApp وtg لـ Telegram وgo لـ Google وfb لـ Facebook وig لـ Instagram وds لـ Discord. معرّفات خدماتنا تعمل أيضًا.
  • الدول تستخدم المعرّفات الرقمية للبروتوكول حيثما وُجدت، مثل 0 لروسيا و6 لإندونيسيا و4 للفلبين و22 للهند و187 للولايات المتحدة. معرّفاتنا ورموز ISO تعمل أيضًا.
  • يعيد getCountries وgetServicesList القوائم الكاملة والمحدّثة.
  • معرّف التفعيل id رقم مثل 100000123، وتقبله واجهة REST أيضًا.

فروق يجب معرفتها

  • المبالغ بالدولار الأمريكي بمنزلتين عشريتين، بسعر المطور الخاص بك. وليست بالروبل.
  • يُتجاهَل operator؛ ويُختار لك أفضل عرض متاح.
  • يُرد على الأخطاء كما في البروتوكول الأصلي، بـ HTTP 200 ونص مثل NO_NUMBERS أو NO_BALANCE أو BAD_KEY. الطلبات الكثيرة جدًا تحصل على HTTP 429 مع TOO_MANY_REQUESTS.
  • يعني NO_ACCESS أن المفتاح يفتقر إلى نطاق purchase، أو أن عنوان IP غير مسموح به، أو أن حد الإنفاق اليومي قد بُلغ.
  • الاستئجار غير متاح عبر نقطة النهاية هذه.

كل ما عدا ذلك مشترك مع واجهة REST: المفاتيح نفسها، والحدود، والأسعار، والمبالغ المستردة، وخطافات الويب.

هل كان هذا المقال مفيدًا؟

هل ما زلت تحتاج إلى مساعدة؟

راسلنا. نرد على كل رسالة، عادة خلال ساعات قليلة.

أو راسلنا على support@smsgrab.com