Invalid Token

invalid-token · 401

قرأت الـ API الـ bearer token ولن تقبله، فإعادة المحاولة بالـ token نفسه لن تنجح.

كل الصفحات

الـ detail يذكر أي فحص رفضه. وعندما لم تستطع الـ API فحص الـ token أصلا، تعيد auth-unavailable، وهذا يستحق إعادة المحاولة.

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

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

  • يحمل الـ header مفتاح الـ API نفسه. تأخذ الـ API الـ access token الذي يستبدل به المفتاح، والمفتاح ليس JSON Web Token موقعا.
  • الـ token موقع بمفتاح لا تنشره خدمة الهوية: إما مزور، وإما صنع في مكان آخر.
  • الـ token موقع بسر مشترك، وهي صيغة لم تعد الـ API تقبلها، أو بخوارزمية لا تقبلها.

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

  • خذ access token جديدا. مع الـ CLI ghaym، ضع مفتاح API في GHAYM_TOKEN ودعه يجري الاستبدال.
  • تخلص من الـ token المرفوض بدل أن تعيد المحاولة به.
  • وإذا رفض token جديد أيضا، فتوقف وأخبر المستخدم، واذكر detail و requestId.

مثال على الرد

json
{
  "type": "invalid-token",
  "title": "Invalid Token",
  "detail": "The bearer token is not a signed JSON Web Token.",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/projects",
  "method": "GET",
  "instance": "GET /v1/projects",
  "status": 401,
  "docs": "https://ghaym.me/docs/errors/invalid-token"
}