Comment ouvrir et clôturer un incident depuis un script ou un pipeline de déploiement ?

Ouvrez-en un avec POST /api/v1/services/{slug}/incidents, conservez l’id renvoyé et clôturez-le avec PATCH /api/v1/incidents/{id}/close.

Avant de commencer

Vous avez une clé de l’interface de programmation (API) pour le service.

Étapes

Ouvrez l’incident :

curl -X POST https://statusraptor.com/api/v1/services/acme-cloud/incidents \
  -H "Authorization: Bearer $STATUS_RAPTOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Checkout is failing", "status": "CRITICAL", "message": "Investigating."}'

La réponse contient {"id": "<uuid>", "title": "...", "open": true}.

Clôturez-le avec l’id renvoyé :

curl -X PATCH https://statusraptor.com/api/v1/incidents/<uuid>/close \
  -H "Authorization: Bearer $STATUS_RAPTOR_KEY"

Questions

Pourquoi le statut doit-il être en majuscules ici ?

Pour les incidents, status doit reprendre exactement le nom en majuscules, par exemple CRITICAL.

Que fait la clôture ?

La même chose que dans le back-office : Status Raptor publie des mises à jour « Resolved » et envoie l’email d’incident clôturé.