# قم بالمصادقة باستخدام واجهة برمجة تطبيقات BroadNet

> يحمل كل طلب REST ترويسة Authorization: Bearer مع رمز الوصول الخاص بحسابك في BroadNet. يؤدي غياب الرمز أو عدم صلاحيته إلى الاستجابة 401 مع جسم خطأ بصيغة JSON. أما واجهة HTTP القديمة (/websmpp) فتستقبل بيانات الاعتماد كمعاملات، وهي محفوظة فقط للتكاملات القائمة من حقبة SMPP.

- الرابط الأساسي: https://www.broadnet.me/ar/developers/authentication
- اللغة: ar
- آخر تحديث: 2026-10-21
- الناشر: BroadNet (https://www.broadnet.me)

يحمل كل طلب إلى API BroadNet REST رمز الوصول الخاص بك في ترويسة Authorization: Bearer. يُصدر الرمز لكل حساب ويأتي من حساب BroadNet الخاص بك؛ ولا تتضمن API أي استدعاء يستبدل اسم المستخدم وكلمة المرور بالرمز. يتم رفض الرمز المميز المفقود أو غير الصالح عند بوابة API باستخدام HTTP 401 وجسم JSON يحتوي على حقلين، error وmessage.

> **لا تضع رمز الوصول أبدًا في شيفرة جانب العميل** يمنحك رمز الوصول صلاحيات الإرسال على حسابك. احتفظ به في متغير بيئي أو مدير أسرار، بعيدًا عن نظام التحكم في الإصدار، وتطبيقات الجوال، وشفرة المتصفح، وقم دائمًا باستدعاء API عبر HTTPS.

## بيانات اعتماد /websmpp القديمة

تستخدم API HTTP القديمة الموجودة ضمن /websmpp، والمُخصصة لعمليات التكامل في عصر SMPP، بيانات الاعتماد كمعاملات طلب (اسم المستخدم وكلمة المرور، أو مفتاح الوصول) بدلاً من رمز Bearer. استخدمها فقط إذا كنت تعتمد عليها بالفعل؛ يجب أن تستخدم عمليات التكامل الجديدة API REST الخاصة Bearer.

## أمثلة

### authenticated request

```bash
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 Unauthorized

```json
{
  "error": "Unauthorized",
  "message": "Missing Authorization token"
}
```

## ذو صلة

- [معيار مصادقة وتوقيع واجهة برمجة التطبيقات](https://www.broadnet.me/ar/reference/api-authentication-and-signing)
- [التشغيل السريع](https://www.broadnet.me/ar/developers/quickstart)