واجهة REST API ومفاتيح الوصول
كل ما تفعله لوحة التحكم متاح برمجياً عبر REST API — لبناء تكاملاتك الخاصة مع أنظمتك الداخلية.
مفاتيح الوصول: الرؤى ← للمطورين ← مفاتيح API ← مفتاح جديد. يُعرض المفتاح كاملاً مرة واحدة عند الإنشاء — انسخه فوراً، فلا يُعرض ثانية (نخزّن بصمته المشفرة فقط).
الاستخدام: أرسل المفتاح في ترويسة الطلب:
x-api-key: YOUR_API_KEY
المفتاح مقيّد بمساحة عملك — لا يصل غيرها أبداً.
أمثلة لما تستطيع فعله عبر الواجهة:
• قراءة المحادثات والرسائل وإنشاؤها.
• إدارة العملاء: إنشاء، تحديث بيانات، وسوم.
• إنشاء التذاكر وتحديث حالاتها.
• قراءة مقالات مركز المعرفة وإدارتها.
• جلب بيانات التقارير.
الصيغة: JSON دائماً، وترقيم الصفحات بمعاملي page وper_page في القوائم، وأخطاء واضحة برموز HTTP القياسية.
التوثيق الكامل بالأمثلة الحية على مركز المطورين: awn.care/developers — لكل نقطة نهاية طلبها ونموذج استجابتها.
أمان: عامل مفتاحك ككلمة مرور — لا تضعه في كود واجهة أمامية أو مستودع عام. سرّب؟ احذفه وأنشئ بديلاً فوراً من نفس الصفحة.
هل كان هذا المقال مفيداً؟
التعليقات
لا توجد تعليقات بعد