PagerDuty freut sich, die neue Version unseres beliebten Produkts anzukündigen. PagerDuty REST-API ist jetzt für alle als Betaversion verfügbar!

Wir haben eine Weile intensiv an dieser Version der API gearbeitet und freuen uns über die Verbesserungen in Geschwindigkeit, Konsistenz und Benutzerfreundlichkeit, die API v2 bietet.

Wenn Sie PagerDuty Kunde sind, nutzen Sie die API v2 bereits seit einiger Zeit mit unserer Webanwendung. Unsere Erfahrung zeigt, dass die Arbeit mit und die Entwicklung neuer Funktionen mit der API v2 einfacher ist als je zuvor.

Was ist neu?

Genau richtig, aber nicht zu viel! PagerDuty Nutzer und -Enthusiasten haben Folgendes entwickelt: eine beeindruckende Menge Wir verwenden API v1 und möchten es mehr Entwicklern erleichtern, dasselbe zu tun, ohne die Welt für unsere engagierte Community zu verändern.

Stattdessen haben wir uns darauf konzentriert, die in unserer API verwendeten Muster zu verfeinern, zu standardisieren und zu vereinfachen. Wir haben über die Jahre viel wertvolles Feedback erhalten und arbeiten an der Lösung vieler Herausforderungen, mit denen Entwickler konfrontiert waren. Wir bieten Entwicklern bessere Werkzeuge für die Entwicklung und Interaktion mit der API – angefangen mit einer brandneuen Entwicklerportal und die Möglichkeit, direkt über einen Webbrowser mit der API v2 zu experimentieren.

Hier nur einige der Höhepunkte:

Wir haben unsere API-URLs vereinfacht. Anstatt die Subdomain eines Kontos zu kennen, senden Sie einfach alle Anfragen an api.pagerduty.com. Wir ermitteln anhand der Authentifizierung automatisch, welches Konto Sie verwenden möchten. Auch der Stammpfad /api/v1 gehört der Vergangenheit an – jetzt verwenden Sie einfach /incidents oder /schedules!

– Wir haben alle unsere Ressourcentypen standardisiert, sodass ein Benutzer immer ein Benutzer und ein Dienst immer ein Dienst ist, egal wo sie in der API erscheinen.

– Wir starten ein neues On-Calls-API Dadurch wird der Zugriff auf Informationen darüber, wer wann wofür Bereitschaftsdienst hat, einfacher als je zuvor.

– Wir halten uns noch genauer an REST-Architekturbeschränkungen Die HTTP-Verben funktionieren wie erwartet, und für jede Ressource werden URIs bereitgestellt.

Wir haben jeder Ressource eine „Zusammenfassung“ hinzugefügt, die sie beschreibt. Hier finden Sie alle Informationen, um eine Ressource zu benennen und zu identifizieren.

– Wir haben generell Maßnahmen ergriffen, um Dinge in der v1 API zu vereinfachen oder zu eliminieren, die nicht unbedingt notwendig waren, nicht verwendet wurden oder bei den Entwicklern Verwirrung stifteten.

Unser Migrationsleitfaden von Version 1 zu Version 2 enthält alle Details darüber, welche Dinge sich geändert haben, und unser neues Referenzdokumentation unterstützt durch eine umfassende Open API Initiative-Spezifikation Enthält alle Details zu unseren unterstützten Endpunkten.

Der PagerDuty Events API Die Version wird separat verwaltet und ist von diesen Änderungen nicht betroffen. Alle Ihre PagerDuty Integrationen können weiterhin wie gewohnt Ereignisse an PagerDuty senden.

Wie fange ich an?

Geh rüber zu die Beta-Dokumentation Hier finden Sie Informationen zu Endpunkten, Mustern, Authentifizierung, Codebeispielen und mehr. Beginnen Sie mit API-Aufrufen direkt aus der Dokumentation, bevor Sie auch nur eine Zeile Code schreiben!

Wenn Sie bestehenden API v1-Code migrieren, Migrationsleitfaden von Version 1 zu Version 2 soll Ihnen helfen, einen guten Start hinzulegen.

Beachten Sie, dass sich API v2 derzeit in der Beta-Phase befindet. Wir raten Ihnen dringend davon ab, die API v2 bereits jetzt für Produktionsfunktionen zu verwenden.

Davon abgesehen würden wir uns sehr freuen, wenn Sie die API v2 in Ihrer Testumgebung ausprobieren und uns Ihr Feedback geben! preisgekröntes Kundensupport-Team steht Ihnen jederzeit zur Verfügung, um Sie schnell auf den neuesten Stand zu bringen, oder Sie können sich direkt an unser Entwickler- und Community-Team wenden unter developers@pagerduty.com Die

Wir freuen uns riesig darauf, die fantastischen Dinge zu sehen, die Sie mit API v2 entwickeln werden!