انتقل إلى المحتوى

رموز واجهة برمجة التطبيقات (API tokens)

يتيح رمز الوصول الشخصي (personal access token) لسكربت أو مهمة CI أو أي تكامل استدعاء واجهة Empi REST API بصفتك أنت. فهو يرى بالضبط ما تراه ويستطيع تغيير بالضبط ما تستطيع تغييره.

رموز الوصول الشخصية في Settings

إنشاء رمز

  1. افتح Settings > API.
  2. انقر Create token.
  3. أعطه اسمًا (Name) (مثلًا "CI pipeline") لتتعرّف عليه لاحقًا.
  4. اختر صلاحياته (Permissions): Read-only (طلبات GET فقط) أو Read & write (قراءة البيانات وتعديلها).
  5. اختر مدة الصلاحية (Expiration): 7 أيام، 30 يومًا، 90 يومًا، سنة واحدة، أو بلا انتهاء.
  6. انقر Create، ثم انسخ السر (secret).

Warning

يُعرض السر مرة واحدة فقط، عند الإنشاء. فهو يمنح وصولًا إلى مساحة عملك بأكملها، لذا احفظه كما تحفظ كلمة مرور (مدير أسرار، مخزن أسرار CI الخاص بك) ولا تلصقه أبدًا في مستند مشترك أو مستودع عام. إذا تسرّب رمز، ألغِه فورًا: يسري الإلغاء على الفور.

يعرض كل صف رمز متى تنتهي صلاحيته ومتى استُخدم آخر مرة، حتى تتمكن من رصد رمز نسيته.

استخدام رمز

أرسله كرمز حامل (bearer token) في طلبات API الخاصة بك. تجد القائمة الكاملة لنقاط النهاية (endpoints) ومعاملاتها واستجاباتها في مرجع API.

إلغاء رمز

انقر Revoke على صف الرمز وأكِّد. يتوقف الرمز عن العمل فورًا ولا يمكن استعادته. أنشئ رمزًا جديدًا إن كنت لا تزال بحاجة إلى الوصول.

تُنسب الاستدعاءات التي تتم برمز إلى API في سجل النشاط الخاص بك.

Tip

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