Skip to main content
تُدار المفاتيح في تطبيق Chattler، في صفحة التكاملات الخاصة بالوكيل، ضمن بطاقة الوصول عبر API. لا يوجد استدعاء API ينشئ مفتاحًا.

​
إنشاء مفتاح

1

افتح الوكيل

في التطبيق، افتح الوكيل الذي تريد إتاحته وانتقل إلى صفحة التكاملات الخاصة به.
2

أضف مفتاحًا في بطاقة الوصول عبر API

أعطِ المفتاح اسمًا واختر صلاحيته:
  • read-only: عرض المحادثات وقراءة الرسائل.
  • full: كل ما سبق، بالإضافة إلى نقطتي نهاية الدردشة.
3

انسخ المفتاح الآن

يُعرض المفتاح الخام مرة واحدة فقط، مباشرة بعد الإنشاء. يبدو هكذا:
الجزء السري وحده هو ما يصادق. أما الجزء key_id فهو علني وهو معرّف المفتاح في كل مكان في لوحة التحكم. إذا فقدت السر، دوّر المفتاح.

​
تدوير المفتاح

التدوير يُصدر سرًا جديدًا ويُبطل القديم فورًا. يبقى معرّف المفتاح ومحادثاته وإحصائياته مرتبطة بالمفتاح نفسه، لذلك التدوير هو الرد الصحيح على أي تسريب مشتبه به: لا يتغير شيء آخر.

​
حذف المفتاح

حذف المفتاح يزيله. من تلك اللحظة يفشل كل طلب به بالخطأ 401 invalid_api_key، بلا فرق عن مفتاح لم يوجد قط. تبقى محادثاته وسجل طلباته قابلة للقراءة في لوحة التحكم. لا يمكن التراجع عن الحذف؛ أنشئ مفتاحًا جديدًا بدلًا منه.
لا تضع المفتاح أبدًا في حزمة متصفح أو تطبيق جوال أو أي عميل لا تتحكم فيه. المفتاح بيانات اعتماد طويلة الأمد للمالك وينفق من رصيده. استدعِ API من الخادم الخلفي الخاص بك، ودوّر المفتاح فور الاشتباه بتسريبه.

​
المصادقة بالمفتاح

لا تُقبل إلا ترويسة Authorization بنظام Bearer. تُتجاهل بيانات الاعتماد في سلسلة الاستعلام، ولا دخل لأي رمز من لوحة التحكم ولا لترويسة Browser-ID.
المفتاح مرتبط بوكيل واحد. استخدامه مع {agent_id} مختلف يُرجع 403 agent_mismatch.

​
الإحصائيات

لا يُعرض الاستخدام في بطاقة الوصول عبر API. افتح صفحة الإحصائيات الخاصة بالوكيل واختر المفتاح في مرشّح التكامل؛ كل مفتاح مدرج هناك كتكامل مستقل. تعرض الصفحة بعدها، لكل مفتاح ولكل يوم بتوقيت UTC، عدد الطلبات، والطلبات الناجحة والفاشلة، ونسبة الأخطاء، ومتوسط زمن الاستجابة وزمن الاستجابة p95، والمستخدمين الفريدين، والمحادثات النشطة، والرموز، والمبلغ المحصّل، إضافة إلى تفصيل حسب نقطة النهاية وحالة HTTP ورمز الخطأ. لا تُكشف تكلفة المزوّد أبدًا؛ المبلغ المعروض هو ما حُصّل من الرصيد.