واجهة الشركاءالدعم نظرة عامة على API
عنوان URL الأساسي
Sandbox (المضيف العام الحالي):
https://api.morisbox.com/api/v1
تقع جميع نقاط النهاية تحت /api/v1 ما لم يُذكر خلاف ذلك.
| البيئة | عنوان URL الأساسي |
|---|
| Sandbox | https://api.morisbox.com/api/v1 |
| Docker محلي | http://127.0.0.1:11300/api/v1 |
الاصطلاحات
| الموضوع | القاعدة |
|---|
| التنسيق | طلب JSON / استجابة JSON |
| المصادقة | Authorization: Bearer <api_key> |
| أرقام الهاتف | E.164 (+228XXXXXXXX) |
| التواريخ | سلاسل ISO-8601 |
| الأخطاء | { "error": { "code", "message" } } |
| الإنشاء الناجح | عادةً 201 |
سطحا API
| السطح | المفتاح | الجمهور | الوثائق |
|---|
| Partner API | sk_… | المؤسسات الشريكة | هذا الموقع (الرسائل والروبوتات…) |
| Developer API | sk_dev_… | المطورون المستقلون | docs.morisbox.com/developers |
مجموعات الموارد (الشركاء)
مجموعات الموارد (المطورون)
| المجموعة | البادئة | الوثائق |
|---|
| المصادقة | /auth/developer/* | المطورون |
| الملف الشخصي / الإعدادات | /dev/me, /dev/settings | المطورون |
| المفاتيح | /dev/api-keys | المطورون |
| قوالب MorisBox | /dev/templates | المطورون |
| الرسائل | /dev/messages | المطورون |
مثال للشريك: سرد الرسائل
GET /api/v1/messages?phone=%2B228XXXXXXXX&limit=20
Authorization: Bearer sk_…
مثال للمطور: الإرسال باستخدام قالب
POST /api/v1/dev/messages
Authorization: Bearer sk_dev_…
Content-Type: application/json
{
"phone": "+228XXXXXXXX",
"template_code": "notification",
"lang": "fr",
"vars": { "text": "Bonjour" }
}
حدود الطلبات
قد تُطبق حدود لكل مفتاح. عند تقييد المعدل: 429 + إشارة إلى وقت إعادة المحاولة. فضّل عمليات البث للأحجام الكبيرة (الشركاء).
الإصدارات
الإصدار العام الحالي: v1. ستستخدم التغييرات غير المتوافقة بادئة جديدة (/api/v2) أو فترة إهمال موثقة.
