الإصدارات

1الطلب

المفتاح السري في X-Blipit-Key. الجسم حتى 2 ميغابايت: version (مطلوب، حتى 256 حرفًا)، وcommit وprevious_commit ‏(git shas، من 7 إلى 40 hex)، وrepo ‏(owner/name)، وcommits (قائمة اختيارية من git log: sha والرسالة والمؤلف والملفات المتغيرة، حتى 250). بدون previous_commit يحتفظ Blipit بالالتزامات بعد التزام الإصدار الأخير، أو بالرأس فقط للإصدار الأول.

curl https://in.blipit.io/api/v1/releases \
  -H "Content-Type: application/json" -H "X-Blipit-Key: <secret key>" \
  -d '{"version":"shop@1.4.2","commit":"9fceb02a","previous_commit":"3a1c7f0d","repo":"acme/shop"}'

2الاستجابات

200 {version, commits, source (github أو cli أو null), previous_commit, warning?}. يذكر التحذير متى فشل البحث في GitHub واستُخدمت التزامات CLI. 400 لإصدار أو sha أو repo غير صالح. 401 مفتاح مجهول، 403 مفتاح عام.

من المفيد معرفته

• يجوز أن يكون repo بصيغة owner/name فقط؛ يُرفض أي شيء يحتوي على @ أو // أو .. أو ? أو # أو مقاطع إضافية كي لا تصل استدعاءات GitHub إلا إلى api.github.com/repos/owner/name.
• لجلب مقارنة GitHub مهلة 10 ثوانٍ ويقرأ الملفات المتغيرة لأحدث 30 التزامًا.