واجهة REST API ومفاتيح الوصول

دقيقة قراءة31 أكتوبر 2026

كل ما تفعله لوحة التحكم متاح برمجياً عبر REST API — لبناء تكاملاتك الخاصة مع أنظمتك الداخلية.

مفاتيح الوصول: الرؤى ← للمطورين ← مفاتيح API ← مفتاح جديد. يُعرض المفتاح كاملاً مرة واحدة عند الإنشاء — انسخه فوراً، فلا يُعرض ثانية (نخزّن بصمته المشفرة فقط).

الاستخدام: أرسل المفتاح في ترويسة الطلب: x-api-key: YOUR_API_KEY

المفتاح مقيّد بمساحة عملك — لا يصل غيرها أبداً.

أمثلة لما تستطيع فعله عبر الواجهة:

  • قراءة المحادثات والرسائل وإنشاؤها.
  • إدارة العملاء: إنشاء، تحديث بيانات، وسوم.
  • إنشاء التذاكر وتحديث حالاتها.
  • قراءة مقالات مركز المعرفة وإدارتها.
  • جلب بيانات التقارير.

الصيغة: JSON دائماً، وترقيم الصفحات بمعاملي page وper_page في القوائم، وأخطاء واضحة برموز HTTP القياسية.

التوثيق الكامل بالأمثلة الحية على مركز المطورين: awn.care/developers — لكل نقطة نهاية طلبها ونموذج استجابتها.

أمان: عامل مفتاحك ككلمة مرور — لا تضعه في كود واجهة أمامية أو مستودع عام. سرّب؟ احذفه وأنشئ بديلاً فوراً من نفس الصفحة.

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

التعليقات

لا توجد تعليقات بعد