نظرة عامة على الـ API
مقدمة عن واجهة برمجة تطبيقات Mersal — الرابط الأساسي، عائلات النقاط الطرفية، والخطوات التالية.
تتيح لك واجهة برمجة تطبيقات Mersal إرسال رسائل SMS وWhatsApp والبريد الإلكتروني، والوصول إلى إكمالات الذكاء الاصطناعي، مباشرة من الخادم الخاص بك بدلاً من لوحة التحكم. تستخدم جميع الطلبات والاستجابات صيغة JSON.
الرابط الأساسي
https://mersal.it/apiعائلتان من النقاط الطرفية
تنقسم واجهة برمجة تطبيقات Mersal إلى عائلتين تستخدمان آليات مصادقة مختلفة:
- نقاط إرسال القنوات —
/api/sms/send،/api/whatsapp/send،/api/email/send، والنقاط المرتبطة بالاستعلام عن الحالة. تتم مصادقتها باستخدام مفتاح API الخاص بك عبر ترويسةApi-key(مع إمكانية بديلة عبر معامل الرابط أو نص الطلب). راجع المصادقة. - بوابة الذكاء الاصطناعي (AI Gateway) —
/api/ai/v1/chat/completionsو/api/ai/v1/models. هذه نقطة طرفية متوافقة مع OpenAI وتتم مصادقتها برمز Bearer منفصل يُنشأ خصيصًا للوصول إلى AI Pool. راجع بوابة الذكاء الاصطناعي: إكمالات المحادثة.
ترويسة Api-key الخاصة بالقنوات ورمز Authorization: Bearer الخاص ببوابة الذكاء الاصطناعي نوعان مختلفان من المفاتيح، يتم إنشاؤهما في مكانين مختلفين من لوحة التحكم. لا يمكن استخدام أحدهما بدلاً من الآخر.
إرسال الرسائل
لكل قناة نقطة طرفية مخصصة وشكل طلب خاص بها:
SMS: الإرسال
POST /api/sms/send — رسائل نصية باسم مرسل معتمد أو عبر شريحة أندرويد.
WhatsApp: الإرسال
POST /api/whatsapp/send — نصوص ووسائط (صور، ملفات، صوت، فيديو).
Email: الإرسال
POST /api/email/send — بريد HTML مع DKIM وتتبع الفتح.
تقبل الثلاثة جميعًا مصفوفة contact، مما يتيح لك الإرسال إلى عدة مستلمين في طلب واحد.
الاستعلام عن حالة الإرسال
للاستعلام عن حالة الرسائل التي أرسلتها بالفعل، توفر Mersal نقاط قراءة لكل قناة:
مرّر معرّف رسالة محددًا لجلب ذلك السجل وحده، أو احذف {id} لعرض أحدث عمليات الإرسال لتلك القناة. تستخدم هذه النقاط نفس مصادقة Api-key المستخدمة في نقاط الإرسال.