مفاتيح API

مفتاح API هو هوية مجموعتك أمام الأنظمة الخارجية: به يعرض موقعك قائمتك ويستقبل حجوزاتك ورسائل عملائك (ربط موقع خارجي). المفتاح سرّ: من يملكه يخاطب بيانات مجموعتك في حدود أذوناته.

صفحة مفاتيح API: إنشاء مفتاح والمفاتيح الحالية

لمن هذه الصفحة؟

لمسؤول المجموعة ومطوّر موقعها.

ما تحتاجه أولًا

قاعدة بيانات للمجموعة، وموقع أو نظام سيستعمل المفتاح.

إنشاء مفتاح

المفتاح معروضًا مرة واحدة بعد الإنشاء

  1. افتح إدارة مفاتيح API من لوحة مجموعتك واضغط إنشاء مفتاح جديد.
  2. التسمية — سمّه باسم مستهلكه («موقع المطعم») لا باسم عام.
  3. الأذونات — أضيق ما يكفي: مفتاح العرض لا يحتاج صلاحية كتابة.
  4. تاريخ الانتهاء (اختياري) وعناوين IP المسموح بها (اختياري) — عنوان أو نطاق CIDR في كل سطر.
  5. اضغط إنشاء المفتاح ثم نسخ — المفتاح يُعرض هذه المرة فقط؛ خزّنه في مكان آمن لدى الموقع، لا في بريد أو ملف مشترك.

ما تراه بعدها

جدول المفاتيح بحالاتها: نشط ومُبطَل

الجدول يعرض لكل مفتاح: التسمية والأذونات وآخر استخدام والانتهاء والحالة — «آخر استخدام» أسرع طريقة لاكتشاف مفتاح ميت أو مفتاح يعمل من حيث لا تتوقع.

حدود يجب فهمها

  • قائمة عناوين IP تضبط النداءات الآتية من الإنترنت؛ النداء عبر العنوان الداخلي لا تحجبه القائمة — فلا تجعلها بديلًا عن سرية المفتاح.
  • تسريب المفتاح = أبطِله فورًا وأنشئ غيره؛ الإبطال لا يكسر إلا من يستعمل المفتاح الملغى.

أخطاء شائعة

  • مفتاح واحد بكل الأذونات لكل شيء — مفتاح لكل مستهلك، بأضيق إذن.
  • نسخ المفتاح إلى محادثة أو مستند «مؤقتًا».
  • نسيان مفاتيح منتهية الصلاحية ثم استغراب توقف الموقع — راجع تاريخ الانتهاء و«آخر استخدام».

صفحات ذات صلة

ربط موقع خارجي · قاعدة البيانات · أدوات الأعمال

افتح هذه الشاشة في التطبيق