Overview
يحمل كل طلب إلى API BroadNet REST رمز الوصول الخاص بك في ترويسة Authorization: Bearer. يُصدر الرمز لكل حساب ويأتي من حساب BroadNet الخاص بك؛ ولا تتضمن API أي استدعاء يستبدل اسم المستخدم وكلمة المرور بالرمز. يتم رفض الرمز المميز المفقود أو غير الصالح عند بوابة API باستخدام HTTP 401 وجسم JSON يحتوي على حقلين، error وmessage.
بيانات اعتماد /websmpp القديمة
تستخدم API HTTP القديمة الموجودة ضمن /websmpp، والمُخصصة لعمليات التكامل في عصر SMPP، بيانات الاعتماد كمعاملات طلب (اسم المستخدم وكلمة المرور، أو مفتاح الوصول) بدلاً من رمز Bearer. استخدمها فقط إذا كنت تعتمد عليها بالفعل؛ يجب أن تستخدم عمليات التكامل الجديدة API REST الخاصة Bearer.
أمثلة
انسخ والصق واستبدل القيم النائبة — هذه الأمثلة تستدعي واجهة API لبيئة الإنتاج كما هي مكتوبة.
authenticated requestbash
curl -X POST https://api.broadnet.me/sms/identify \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "message": "Hello from BroadNet" }'401 Unauthorizedjson
{
"error": "Unauthorized",
"message": "Missing Authorization token"
}