QATrax
عرض بصيغة Markdown

مرجع API

مسارات الأتمتة، ومصادقتها، وردودها.


المصادقة

Authorization: Bearer <clé de CI>. المفتاح صالح لمشروعه وعملياته فقط؛ المفتاح الغائب، أو غير الصالح، أو الملغى، أو المنتهي الصلاحية يتلقى 401؛ والمسار الخارج عن الأتمتة، 403. الردود بصيغة JSON.

المسارات

الطريقةالمسارالعمليةالدور
POST/importpousserاستيراد خطة التطوير والاختبار (يُقرأ المشروع من الخطة)
POST/runs?p=<projet>&format=jsonpousserنتائج اختبارات (JUnit XML، NUnit، TRX، TestNG، Robot، CTest، Cucumber، Behave، Allure، CTRF، TAP أو JSON؛ انظر صيغة النتائج)
POST/sbom?p=<projet>&version=<v>[&motif=…]pousserقائمة SBOM بصيغة CycloneDX أو SPDX؛ الإيداع المختلف يصبح مراجعة (الرد: revision، nouvelleRevision)؛ السبب اختياري لنظام CI، وقيمته الافتراضية «dépôt de la CI» (إيداع نظام CI) — انظر التصحيح دون محو
GET/livrable?p=<projet>pousserحالة المُسلَّم
POST/livrable?p=<projet>&format=jsonemettreإصدار مُسلَّم مختوم (version=)
GET/livrable/telecharger?no=<numéro>pousserملف JSON المختوم
GET/livrable/certificat?no=<numéro>pousserالشهادة (&format=pdf: ملف PDF موقَّع)

المسارات العامة

الطريقةالمسارالدور
GET/livrable/verifier?no=<numéro>التحقق من مُسلَّم مسجَّل
POST/livrable/verifierالتحقق من الوثيقة التي بحوزتك
GET/cle-publiqueالمفتاح العام للفضاء
GET/api/healthحالة الخدمة، وdemarreLe: وقت بدء تشغيل النسخة
GET/modeles/<fichier>النماذج: resultats-modele.xml، .tap، .json، plan-modele.json
GET/verifierصفحة التحقق من مُسلَّم، دون حساب

إجراءات التصحيح (إلغاء إيداع، تعديل الخطة، إدخال اختبار يدوي) ليست متاحة لمفاتيح CI (403): فهي تُلزم شخصًا، يسجّل دخوله.

الرموز

200 نجاح · 400 طلب ناقص · 401 مفتاح مرفوض · 403 خارج نطاق المفتاح (أو فضاء للقراءة فقط) · 409 تحقق سلبي · 413 متن كبير جدًا · 422 خطة أو وثيقة غير صالحة · 503 خدمة غير مهيّأة (يبيّن الرد ما يجب ضبطه).