X-Api-Key. لا توجد بيانات اعتماد أخرى لإدارتها — لا تدفّق OAuth ولا رموز
بحاجة إلى تجديد.
إنشاء مفتاح API
تُنشأ مفاتيح API داخل المنصة، وليس عبر الواجهة.1
افتح مفاتيح API
في التطبيق، انتقل إلى الإعدادات ← التكاملات ← مفاتيح API
(
/settings/integration/api-keys). راجع مفاتيح API
للاطّلاع على مرجع الإعدادات الكامل.2
سمِّ المفتاح وحدّد نطاقاته
امنح المفتاح اسمًا وصفيًا واختر فقط النطاقات التي يحتاجها التكامل (مثل
invoices:write).3
انسخ السرّ
اختر Create API Key. يُعرض السرّ — الذي يبدو بالشكل
fat_… — مرة واحدة
فقط. انسخه فورًا واحفظه بأمان؛ لن تتمكّن من رؤيته مجددًا.إرسال المفتاح
أضِف المفتاح إلى ترويسةX-Api-Key في كل طلب:
نطاق المفتاح وأمانه
- شركة واحدة لكل مفتاح. يقتصر نطاق كل مفتاح على شركة/مستأجر واحد. للتكامل مع عدّة شركات، أنشئ مفتاحًا لكل شركة.
- أقل صلاحية ممكنة. امنح فقط النطاقات التي يستخدمها التكامل.
- تعامل معه كأنه كلمة مرور. احفظ المفاتيح في مدير أسرار، ولا تضعها أبدًا في نظام التحكّم بالمصدر أو في كود يعمل على جهة العميل.
التالي
- البدء السريع — أنشئ أول فاتورة لك.
- معرّف عدم التكرار — اجعل عمليات الكتابة آمنة لإعادة المحاولة.