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

لمن هذه الصفحة؟
لمسؤول المجموعة ومطوّر موقعها.
ما تحتاجه أولًا
قاعدة بيانات للمجموعة، وموقع أو نظام سيستعمل المفتاح.
إنشاء مفتاح

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

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