المصادقة عبر API

إن كنت مطورًا وتريد توصيل منصة ربط CRM بتطبيقك أو موقعك، ستحتاج إلى مفتاح API للتحقق من هويتك مع كل طلب.

إنشاء مفتاح API

انتقل إلى الإعدادات ← المطورون

صفحة المطورين

اضغط إنشاء مفتاح جديد
أدخل اسمًا وصفيًا للمفتاح (مثلًا: "تطبيق الموبايل" أو "موقع الويب")
اضغط إنشاء
انسخ المفتاح فورًا — لن يُعرض مرة أخرى لأسباب أمنية

جرّب الـ API مباشرةً من المنصة

صفحة المطورون تحتوي على ملعب API (Playground) يتيح لك اختبار الطلبات مباشرةً بدون أي أدوات خارجية:

التبويب	ما يفعله
إرسال نص	اختبر إرسال رسالة نصية لرقم معين
إرسال وسائط	اختبر إرسال صورة أو ملف
إرسال صوت	اختبر إرسال رسالة صوتية

كل تبويب يعرض لك النقطة الطرفية (Endpoint) ومثال الطلب بصيغة cURL جاهز للنسخ.

استخدام مفتاح API في الطلبات

أضف مفتاح API كـ Authorization header في كل طلب HTTP:

Authorization: Bearer YOUR_API_KEY_HERE
Content-Type: application/json

مثال باستخدام cURL

curl -X GET https://rabtcrm.com/api/v1/contacts \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"

مثال باستخدام JavaScript (fetch)

const response = await fetch('https://rabtcrm.com/api/v1/contacts', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY_HERE',
    'Content-Type': 'application/json',
  },
});
const data = await response.json();

مثال باستخدام Python

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY_HERE',
    'Content-Type': 'application/json',
}

response = requests.get('https://rabtcrm.com/api/v1/contacts', headers=headers)
data = response.json()

رموز الاستجابة

الرمز	المعنى
`200 OK`	الطلب نجح
`201 Created`	تم إنشاء سجل جديد بنجاح
`400 Bad Request`	خطأ في بيانات الطلب
`401 Unauthorized`	مفتاح API غير صحيح أو مفقود
`403 Forbidden`	لا تملك الصلاحية لهذه العملية
`404 Not Found`	المورد غير موجود
`429 Too Many Requests`	تجاوزت حد الطلبات — انتظر قبل المحاولة
`500 Server Error`	خطأ في الخادم — تواصل مع الدعم

أمان مفاتيح API

لا تضع مفتاح API في كود JavaScript من جانب العميل (frontend)
لا تشاركه في GitHub أو أي مستودع عام
في حال تسريبه، احذفه فورًا من الإعدادات وأنشئ مفتاحًا جديدًا
استخدم متغيرات البيئة (Environment Variables) لتخزين المفتاح

حذف مفتاح API

انتقل إلى الإعدادات ← المطورون
ابحث عن المفتاح في القائمة
اضغط على أيقونة الحذف بجانبه
أكّد الحذف

المفتاح يُلغى فورًا وتفشل أي طلبات تستخدمه.

الخطوة التالية

← إرسال الرسائل عبر API