Offizielle Clients für PHP und Laravel

Löscht ein Token einen Service mit delete_orphaned_incidents oder delete_orphaned_maintenances, braucht er jetzt zusätzlich Vorfälle löschen bzw. Wartungen löschen, sonst antwortet die API mit 403. Ein Token, dessen Ersteller auf Zugriffsbereiche beschränkt ist, verknüpft Vorfälle und Wartungen nur noch mit Services und Statuspages aus diesen Bereichen. Nutzt dein Skript einen der beiden Parameter, gib seinem Token die passende Berechtigung.

Mit livck/cloud-php steuerst du LIVCK Cloud aus PHP, ohne JSON von Hand zu bauen. Services entstehen über einen typisierten Builder, jeder Fehler kommt als eigene Exception, und Listen blättert der Client selbst durch. Bricht eine Verbindung ab, wiederholt er die Anfrage mit demselben Idempotency-Key, und nichts wird doppelt angelegt. livck/cloud-laravel ergänzt Konfiguration, Facade, mehrere Verbindungen und einen Fake für Tests. Beide Pakete stehen unter der MIT-Lizenz.

• composer require livck/cloud-php
• composer require livck/cloud-laravel

Anleitungen: PHP-SDK und Laravel

Im Feld tags eines Services stehen jetzt Namen oder IDs, auch gemischt: tags: ["kunde:4711", "env=prod"]. Einen neuen Namen legt die API gleich mit an. Nur ein Eintrag, der wie eine Tag-ID aussieht (21 Zeichen mit mindestens einem Großbuchstaben), muss ein bestehender Tag sein.

GET /v1/statuspages?slug=kunde-4711 liefert genau diese Seite oder eine leere Liste. Jede Statuspage nennt jetzt in url ihre öffentliche Adresse, und jede Komponente in effective_status den Status, den Besucher sehen.

Stößt ein Service oder eine eigene Domain an ein Limit deines Plans, nennt die Antwort mit 403 jetzt in upsell das betroffene Limit, dazu limit und usage. So unterscheidet ein Skript ein volles Kontingent von fehlenden Rechten.

Fehlermeldungen der API sind jetzt immer englisch, auch bei Organisationen mit deutschen Inhalten. Accept-Language bestimmt nur noch die Sprache der Inhalte, etwa der Titel von Vorfällen.

GET /v1/services?tag= mit leerem Wert liefert jetzt eine leere Liste statt aller Services. Ein Skript, dessen Variable leer geblieben ist, bekommt so nie versehentlich alle Services.

statuspage_id war bei eigenen Domains leer, jetzt nennt es die Statuspage der Domain.

Eine Statuspage mit email_whitelist: null zu bearbeiten, endete mit 500. Jetzt gilt null als leere Liste.

Auf eine zu große Anfrage kam eine HTML-Seite zurück. Jetzt antwortet die API mit 413 und einer Fehlermeldung als JSON.