المستودعات
المستودعات التي يحق للمستدعي رؤيتها، وتفاصيل كل منها.
عمليات هذه المجموعة مع قاعدة الوصول وقاعدة إعادة المحاولة والمعلمات والاستجابات. يحمل كل طلب مفتاحًا: Authorization: Bearer <key> (راجع «المصادقة»).
العمليات
عرض قائمة المستودعات المتاحة لك
GET HEAD /api/v1/repositories
الوصول: المستودعات التي يحق للمستدعي رؤيتها (repository.read) · إعادة المحاولة: آمن للتكرار (قراءة)
يسرد، مرتبةً حسب الاسم، المستودعات التي يملك المستدعي فيها إذنًا، مع صيغ كل منها (upack وassets) وأذونات المستدعي نفسه فيه؛ أما مفتاح الخدمة المُدار فيرى فقط المستودعات التي يملك فيها repository.read. المستودع هو نطاق ما مُنح للمستدعي، وليس مدخلًا في سجل على مستوى الخادم. تحتوي الصفحة على limit بطاقة (من 1 إلى 100، والافتراضي 50)؛ وللمتابعة اضبط after على قيمة next.
المعلمات
| الاسم | الموضع | النوع | مطلوب | القواعد |
|---|---|---|---|---|
after | الاستعلام | string | لا | يطابق النمط ^[a-z0-9][a-z0-9_-]{0,63}$; Exclusive repository ID boundary; authorization is rechecked on every page. |
limit | الاستعلام | integer | لا | 1–100; القيمة الافتراضية 50 |
الاستجابة 200
| الحقل | النوع | مطلوب | القواعد |
|---|---|---|---|
items | مصفوفة من object | نعم | عدد العناصر: 100 كحد أقصى |
items[].id | string | نعم | يطابق النمط ^[a-z0-9][a-z0-9_-]{0,63}$ |
items[].formats | مصفوفة من string | نعم | عدد العناصر: 2–2; بلا عناصر مكرّرة; كل عنصر: إحدى القيم: upack, assets |
items[].permissions | مصفوفة من string | نعم | عدد العناصر: 1–24; بلا عناصر مكرّرة; كل عنصر: إحدى القيم: repository.read, storage.read, storage.manage, diagnostics.read, artifact.read, artifact.list, artifact.delete, artifact.promote, content.read, upload.create, upload.read, upload.write, upload.complete, upload.cancel, job.read, package.read, package.publish, asset.read, asset.write, asset.restore, annotation.read, annotation.write, reference.write, audit.read |
next | string | نعم | يطابق النمط ^[a-z0-9][a-z0-9_-]{0,63}$; يمكن أن يكون null |
الاستجابات: 200, 400, 401, 403, 404, 409, 422, 503, 507
مثال
curl -X GET "$ARKVORY_URL/api/v1/repositories" \
-H "Authorization: Bearer $ARKVORY_TOKEN"الحصول على بطاقة مستودع
GET HEAD /api/v1/repositories/{repository}
الوصول: المستودعات التي يحق للمستدعي رؤيتها (repository.read) · إعادة المحاولة: آمن للتكرار (قراءة)
يعيد بطاقة المستدعي لمستودع واحد: صيغه وأذونات المستدعي فيه. المستودع الذي لا يستطيع المستدعي رؤيته يردّ بـ 404 تمامًا كالمستودع غير الموجود؛ ويجعل HEAD هذا فحص وصول رخيصًا. ورؤية المستودع لا تمنح وصولًا إلى محتواه أو إعداداته.
المعلمات
| الاسم | الموضع | النوع | مطلوب | القواعد |
|---|---|---|---|---|
repository | المسار | string | نعم | يطابق النمط ^[a-z0-9][a-z0-9_-]{0,63}$ |
الاستجابة 200
| الحقل | النوع | مطلوب | القواعد |
|---|---|---|---|
id | string | نعم | يطابق النمط ^[a-z0-9][a-z0-9_-]{0,63}$ |
formats | مصفوفة من string | نعم | عدد العناصر: 2–2; بلا عناصر مكرّرة; كل عنصر: إحدى القيم: upack, assets |
permissions | مصفوفة من string | نعم | عدد العناصر: 1–24; بلا عناصر مكرّرة; كل عنصر: إحدى القيم: repository.read, storage.read, storage.manage, diagnostics.read, artifact.read, artifact.list, artifact.delete, artifact.promote, content.read, upload.create, upload.read, upload.write, upload.complete, upload.cancel, job.read, package.read, package.publish, asset.read, asset.write, asset.restore, annotation.read, annotation.write, reference.write, audit.read |
الاستجابات: 200, 400, 401, 403, 404, 409, 422, 503, 507
مثال
curl -X GET "$ARKVORY_URL/api/v1/repositories/$REPOSITORY" \
-H "Authorization: Bearer $ARKVORY_TOKEN"