كيف تتم المصادقة؟
أرسل مفتاح API في الترويسة x-api-key مع كل طلب، من الخادم المسجَّل عنوان IP الخاص به لهذا المفتاح.
يحمل كل طلب المفتاح في ترويسة HTTP:
x-api-key: مفتاح_API_الخاص_بك
تأتي المفاتيح بالصيغة hma_<prefix>_<secret>. يُعرض المفتاح مرة واحدة عند إنشائه، لذا ضعه فورًا في مخزن الأسرار على خادمك. أبقِه على الخادم: لا تضعه أبدًا في متصفح أو تطبيق جوال أو مستودع عام.
يُرفض الطلب الذي لا يحمل مفتاحًا معروفًا بالرمز unauthenticated (HTTP 401). ويُرفض المفتاح الصالح المستخدم من عنوان غير مسجَّل له بالرمز ip_not_allowed (HTTP 403).