Authentication Required

unauthorized · 401

لم تعرف الـ API من ينادي، لأن الطلب لم يحمل أي بيانات دخول تستطيع استعمالها.

كل الصفحات

والـ token المنتهي يصل إلى هنا أيضا. أما الـ token الذي قرأته الـ API ولن تقبله أبدا فيعيد invalid-token.

لا يضيف هذا النوع شيئا إلى الحقول التي في كل خطأ.

الأسباب الشائعة

  • الـ header Authorization غير موجود، أو ليس بصيغة Bearer <token>.
  • انتهى الـ access token. عمر الـ access tokens قصير عن قصد.
  • وصل مع الطلب cookie جلسة المتصفح فقط، وقد انتهت الجلسة.

كيف تصلح الطلب

  • دع الـ CLI ghaym يسجل الدخول عنك: ضع مفتاح API في GHAYM_TOKEN، وهو يستبدله بـ access token ويجدده عندما ينتهي.
  • في النداء المباشر عبر HTTP، أرسل Authorization: Bearer <access token>، وخذ token جديدا عندما يعود هذا الخطأ. وإذا رفض الـ token الجديد أيضا، فتوقف واسأل المستخدم.
  • لا تطبع الـ token ولا المفتاح في السجلات، ولا تكتب أيا منهما في ملفات العمل.

مثال على الرد

json
{
  "type": "unauthorized",
  "title": "Authentication Required",
  "status": 401,
  "detail": "No JWT token or valid session cookie provided",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/projects",
  "method": "GET",
  "instance": "GET /v1/projects",
  "docs": "https://ghaym.me/docs/errors/unauthorized"
}