Repository Not Found

repository-not-found · 404

الـ repo الذي ذكره الطلب ليس مما تستطيع الـ API الوصول إليه عن طريق GitHub.

كل الصفحات

المورد الموجود في workspace آخر يعيد الـ 404 نفسه، لا 403، فلا تستطيع تمييزه عن مورد غير موجود. والـ resourceId يحمل المعرف الذي بحثت عنه الـ API. هنا الـ resourceId هو الـ repo بصيغة owner/repo، والـ detail يذكر أي فحص فشل: لا يوجد تثبيت مربوط يغطيه، أو رد GitHub بأنه غير موجود.

إضافة إلى الحقول التي في كل خطأ، يضيف هذا النوع resourceType و resourceId.

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

  • المعرف خاطئ: خطأ كتابي، أو معرف ناقص، أو معرف منسوخ من workspace آخر.
  • حذف الـ repo بين النداء الذي عرضه في القائمة وهذا النداء.
  • أرسل النداء في workspace غير الذي فيه المورد: يعمل النداء في الـ workspace الذي يسميه الـ header X-Ghaym-Workspace، أو ?workspace=<id> في البث حين يغيب الـ header.
  • لا يوجد تثبيت GitHub App في هذا الـ workspace يغطي الـ repo: لم يعط الـ app وصولا إليه.
  • تغير اسم الـ repo أو نقل أو حذف على GitHub.

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

  • اقرأ resourceId وقارنه بالقيمة التي قصدت إرسالها.
  • اطلب القائمة من جديد وخذ المعرف من جوابها، لا من قيمة محفوظة أو مكتوبة يدويا.
  • وإذا كان المعرف صحيحا وحديثا، فأرسل X-Ghaym-Workspace باسم الـ workspace الذي فيه المورد.
  • لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء.
  • إذا كان الـ repo صحيحا، فأعط الـ app وصولا إليه من GitHub، ثم أرسل النداء نفسه مرة أخرى.
  • اعرض ما يستطيع هذا الـ workspace الوصول إليه بـ ghaym cloud git installations.

مثال على الرد

json
{
  "type": "repository-not-found",
  "title": "Repository Not Found",
  "detail": "GitHub repository 'acme/storefront' is not available through your connected GitHub installations.",
  "resourceType": "Repository",
  "resourceId": "acme/storefront",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/git/branches",
  "method": "GET",
  "instance": "GET /v1/git/branches",
  "status": 404,
  "docs": "https://ghaym.me/docs/errors/repository-not-found"
}