واجهة API الخاصة

وصول برمجي إلى بيانات مساحة عملك في راقي.

تتيح واجهة API الخاصة لبرامجك قراءة جهات الاتصال والمحادثات والوكلاء، وإضافة جهات اتصال جديدة، عبر نقاط REST.

مهم: الوصول إلى API مشمول في خطة Business، وفي بقية الخطط يكون زر إنشاء مفتاح API مقفلاً.

الحصول على مفتاح API

افتح التكاملات وAPI، ومن قسم API وMCP من Raqi اضغط إنشاء مفتاح API في بطاقة الواجهة الخاصة. يبدأ المفتاح بـ rq_live_، ويظهر مرة واحدة فقط، فانسخه فوراً واحفظه في مكان آمن.

مهم: يحفظ راقي بصمة SHA-256 لمفتاحك فقط، ولا يحفظ المفتاح نفسه أبداً. إذا فقدته أو انكشف، افتح إدارة واختر إنشاء مفتاح جديد، فيتوقف المفتاح القديم فوراً.

المصادقة

أرسل المفتاح كـ Bearer token في ترويسة Authorization مع كل طلب:

bash

curl -H "Authorization: Bearer rq_live_your_api_key_here" \
  https://api.raqi.io/api/v1/ping

النقاط المتاحة

كل النقاط محصورة في مساحة عملك وتعيد JSON:

الطريقة	النقطة	الوصف
GET	/v1/ping	فحص الاتصال، ويعيد معرّف مساحة عملك
GET	/v1/contacts	قائمة جهات الاتصال (تدعم ?search= و?page= و?limit=)
GET	/v1/contacts/:id	جهة اتصال واحدة حسب المعرّف
POST	/v1/contacts	إنشاء جهة اتصال جديدة
GET	/v1/conversations	قائمة المحادثات (تدعم ?status= و?page= و?limit=)
GET	/v1/conversations/:id/messages	رسائل محادثة
GET	/v1/agents	قائمة وكلاء AI
GET	/v1/workspace	معلومات مساحة العمل مع أعداد جهات الاتصال والمحادثات والوكلاء

حدود الطلبات

تسمح الواجهة بـ 100 طلب في الدقيقة لكل عنوان IP. وما يزيد على ذلك يعيد الرمز 429 (Too Many Requests).

أمثلة برمجية

إنشاء جهة اتصال عبر الواجهة:

bash

curl -X POST \
  -H "Authorization: Bearer rq_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "Ahmed", "email": "ahmed@example.com", "phone": "+966501234567", "tags": ["website"]}' \
  https://api.raqi.io/api/v1/contacts

استخدام Claude بدلاً من curl

لتعمل مع راقي من Claude بالأوامر النصية بدلاً من السكربتات، راجع دليل خادم MCP. يعمل بالحصر نفسه على مساحة العمل، ولا يحتاج مفتاح API تديره في Claude.ai.

هل كان هذا المقال مفيداً؟