مفاتيح API للمطورين

الإعدادات، قسم مفاتيح API للمطورين (/app/settings#developer). للمالكين والمسؤولين فقط. يتيح المفتاح لبرامجك الاتصال بواجهة OmniBrand العامة بالترويسة Authorization: Bearer ob_live_…

خطوة بخطوة: إنشاء مفتاح

1. اكتب اسمًا في اسم المفتاح (مثل: CI bot)، حتى 60 حرفًا، لتعرف لاحقًا ما الذي يستخدمه.
2. اختر قراءة فقط (قراءة البيانات) أو قراءة وكتابة (الإنشاء والتعديل أيضًا).
3. انقر إنشاء مفتاح.
4. يعرض مربع أصفر "مفتاح API (انسخه الآن - يظهر مرة واحدة):" والمفتاح كاملًا. انسخه الآن واحفظه في مكان آمن؛ فـ OmniBrand لا يحفظ إلا بصمته ولا يمكنه عرضه مرة أخرى.

القائمة

يعرض كل مفتاح اسمه وأول أحرفه (ob_live_…) وصلاحيته وآخر استخدام ("آخر استخدام ..." أو "لم يُستخدم") و"ينتهي ..." مع تاريخ انتهائه. - تدوير: يصدر مفتاحًا جديدًا بالاسم والصلاحية نفسيهما ويعرضه مرة واحدة. يبقى المفتاح القديم يعمل 24 ساعة لتنقل تكاملك إليه، ثم يتوقف. وحتى ذلك الحين يبقى في القائمة غير مشطوب، مع "يعمل المفتاح القديم حتى {التاريخ والوقت}" وزر إلغاء. - إلغاء: يوقف المفتاح فورًا. ويعمل أيضًا على المفتاح القديم خلال ساعاته الأربع والعشرين بعد التدوير: إن دوّرت المفتاح لأنه تسرّب فانقر إلغاء على المفتاح القديم ليتوقف الآن. تبقى المفاتيح الملغاة (والمفاتيح المدوّرة بعد انتهاء ساعاتها الأربع والعشرين) في القائمة مشطوبة.

لمن يعود المفتاح

• المفتاح يعود لمن أنشأه، ويشمل مساحات العمل التي يكون فيها مالكًا أو مسؤولًا لحظة الإنشاء.
• لا يعمل إلا ما دام منشئه مالكًا أو مسؤولًا نشطًا في كل مساحة يشملها. إن أُزيل أو خُفّض دوره أو عُطّل حسابه تفشل الطلبات برسالة (بالإنجليزية) معناها أن منشئ المفتاح لم يعد يدير مساحات عمله، فاطلب من مسؤول حالي إصدار مفتاح جديد.
• لا ترى ولا تدوّر ولا تلغي إلا المفاتيح التي تدير أنت مساحات عملها. في حساب فيه مساحات لعملاء كثيرين لا يرى مسؤول عميل مفاتيح عميل آخر.

إذا حدث خطأ

• رسالة "This API key has expired": تدوم المفاتيح سنة واحدة. انقر تدوير عليه في مفاتيح API للمطورين (أو أنشئ مفتاحًا جديدًا) وحدّث تكاملك.
• رسالة "Invalid or revoked API key": أُلغي المفتاح، أو انتهت مهلة التدوير (24 ساعة)، أو نُسخ ناقصًا.
• لا يستطيع مفتاح API إنشاء مفاتيح أخرى أو تدويرها أو إلغاءها؛ هذا للأشخاص المسجلين فقط.

مقالات ذات صلة

• الأدوار والصلاحيات
• صفحة الإعدادات