مفاتيح API وBearer

تعرّف معظم واجهات API هويتك باستخدام ترويسة بدلًا من نموذج تسجيل الدخول. ويكون الشكل الشائع كما يلي:

curl -s -H 'Authorization: Bearer YOUR_TOKEN' http://127.0.0.1:9132/me

تعني Bearer تمامًا ما يبدو من اسمها: يُعامَل من يحمل هذا الرمز المميّز على أنه أنت. لا يوجد فحص إضافي، ولا كلمة مرور، ولا عامل ثانٍ. ويظل الرمز المميّز المُسرَّب بمثابة حساب مُسرَّب إلى أن يُلغى.

ولهذا تبعات على طريقة تعاملك معه. فالرمز المميّز الموجود في عنوان URL ينتهي به المطاف في سجل المتصفح وسجلات الخادم، ولذلك يجب وضعه في ترويسة. أما الرمز المميّز الموجود في أمر shell، فينتهي به المطاف في سجل shell، ولهذا تقرأه النصوص البرمجية الفعلية من متغير بيئة بدلًا من تضمينه مباشرةً.

تستخدم بعض واجهات API ترويسة باسم مختلف، مثل X-API-Key. والآلية متطابقة: سلسلة سرية في ترويسة، تُرسَل مع كل طلب.