Release

Endpoint POST /api/v1/releases

Chiamalo dalla tua pipeline di deploy (oppure usa blipit releases new). Con un token GitHub salvato sul progetto Blipit recupera i commit da solo; altrimenti usa i commit che invii.

1Richiesta

Chiave segreta in X-Blipit-Key. Corpo fino a 2 MB: version (obbligatoria, fino a 256 caratteri), commit e previous_commit (sha git, da 7 a 40 esadecimali), repo (owner/name), commits (elenco facoltativo da git log: sha, messaggio, autore, file modificati, fino a 250). Senza previous_commit Blipit conserva i commit successivi al commit dell'ultima release, o solo l'head per una prima release.

sh
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"}'

2Risposte

200 {version, commits, source (github, cli o null), previous_commit, warning?}. Il warning indica quando la ricerca su GitHub è fallita e sono stati usati i commit della CLI. 400 per version, sha o repo non validi. 401 chiave sconosciuta, 403 chiave pubblica.

Buono a sapersi

  • repo può essere solo owner/name; qualsiasi cosa con @, //, .., ?, # o segmenti extra viene rifiutata così le chiamate GitHub raggiungono solo api.github.com/repos/owner/name.
  • Il recupero compare di GitHub ha un timeout di 10 secondi e legge i file modificati per i 30 commit più recenti.

Bloccato? Scrivi a support@blipit.io. Le chiavi e il DSN esatto di ogni progetto sono sotto Chiavi API in app.blipit.io.