Wie melde und schließe ich einen Vorfall aus einem Skript oder einer Deployment-Pipeline?

Melde einen mit POST /api/v1/services/{slug}/incidents, behalte die zurückgegebene id und schließe ihn mit PATCH /api/v1/incidents/{id}/close.

Bevor du anfängst

Du hast einen Schlüssel der Programmierschnittstelle (API) für den Dienst.

Schritte

Melde den Vorfall:

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

Die Antwort enthält {"id": "<uuid>", "title": "...", "open": true}.

Schließe ihn mit der zurückgegebenen id:

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

Fragen

Warum muss der Status hier in Großbuchstaben stehen?

Bei Vorfällen muss status der exakte Name in Großbuchstaben sein, zum Beispiel CRITICAL.

Was bewirkt das Schließen?

Dasselbe wie im Backoffice: Status Raptor veröffentlicht „Resolved“-Updates und sendet die E-Mail „Vorfall geschlossen“.