PagerDuty est ravi d'annoncer la nouvelle version de notre populaire API REST PagerDuty est désormais disponible pour que tout le monde puisse l'utiliser en version bêta !

Nous travaillons dur sur cette version de l'API depuis un certain temps et sommes enthousiasmés par les améliorations en termes de vitesse, de cohérence et de facilité d'utilisation offertes par l'API v2.

Si vous êtes client PagerDuty , vous utilisez déjà l'API v2 avec notre application web depuis un certain temps. Notre expérience nous a montré qu'il était plus facile que jamais d'utiliser et de développer de nouvelles fonctionnalités avec l'API v2.

Quoi de neuf?

Juste assez, mais pas trop ! Les utilisateurs et passionnés de PagerDuty ont créé une quantité impressionnante en utilisant l'API v1 et nous voulons permettre à davantage de développeurs de faire de même sans changer le monde pour notre communauté dédiée.

Nous nous sommes plutôt concentrés sur l'amélioration, la standardisation et la simplification des modèles qui apparaissent dans notre API. Nous avons reçu de nombreux retours positifs au fil des ans et nous relevons de nombreux défis rencontrés par les développeurs. Nous leur fournissons également de meilleurs outils pour développer et interagir avec l'API, à commencer par une toute nouvelle interface. portail des développeurs et la possibilité de jouer avec l'API v2 directement depuis un navigateur Web.

Voici quelques-uns des points saillants :

Nous avons simplifié nos URL d'API. Au lieu de connaître le sous-domaine d'un compte, pointez simplement toutes vos requêtes vers api.pagerduty.com et nous déterminerons le compte souhaité grâce à l'authentification. Fini le chemin racine /api/v1 : c'est aussi simple que /incidents ou /schedules !

– Nous avons standardisé tous nos types de ressources afin qu'un utilisateur soit toujours un utilisateur et qu'un service soit toujours un service, peu importe où ils apparaissent dans l'API.

– Nous lançons un nouveau API d'appels Cela rend l'accès aux informations sur qui est de garde, quand et pour quoi, plus simple que jamais.

– Nous adhérons encore plus étroitement à Contraintes architecturales REST Les verbes HTTP fonctionnent comme prévu et des URI sont fournis pour chaque ressource.

– Nous avons fourni à chaque ressource un résumé qui la décrit. C'est votre guichet unique pour obtenir le texte permettant de nommer et d'identifier une ressource.

– Dans l’ensemble, nous avons pris des mesures pour simplifier ou éliminer les éléments de l’API v1 qui n’étaient pas strictement nécessaires, qui n’étaient pas utilisés ou qui causaient de la confusion chez les développeurs.

Notre Guide de migration v1 vers v2 contient tous les détails sur les types de choses qui ont changé, et notre nouveau documentation de référence soutenu par une approche globale Spécification de l'Open API Initiative contient des informations complètes sur tous nos points de terminaison pris en charge.

Le API des événements PagerDuty est versionné séparément et n'est pas affecté par ces modifications. Toutes vos intégrations PagerDuty pourront continuer à envoyer des événements à PagerDuty comme elles l'ont toujours fait.

Comment puis-je commencer ?

Rendez-vous sur la documentation bêta Pour plus d'informations sur les points de terminaison, les modèles, l'authentification, les exemples de code et plus encore, commencez à effectuer des appels d'API directement depuis la documentation avant même d'écrire la moindre ligne de code !

Si vous migrez le code API v1 existant, le Guide de migration v1 vers v2 est là pour vous aider à démarrer sur les chapeaux de roue.

Gardez à l’esprit que l’API v2 est actuellement en version bêta. Nous vous encourageons fortement à ne pas encore utiliser l'API v2 pour aucune fonctionnalité de production.

Ceci étant dit, nous serions ravis que vous commenciez à tester l'API v2 dans votre environnement de test et que vous nous fassiez part de vos commentaires ! équipe de support client primée est toujours disponible pour vous aider à vous mettre à niveau, ou vous pouvez contacter directement notre équipe de développeurs et de communauté à developers@pagerduty.com .

Nous sommes impatients de voir les choses incroyables que vous créez avec l'API v2 !