PagerDuty est ravi d'annoncer la nouvelle version de notre populaire API REST de PagerDuty est désormais disponible pour tout le monde 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 de vitesse, de cohérence et de facilité d'utilisation qu'offre l'API v2.

Si vous êtes client de PagerDuty , vous utilisez déjà l'API v2 avec notre application Web depuis un certain temps. D'après notre propre expérience, il nous a semblé plus facile que jamais de travailler avec l'API v2 et de créer de nouvelles fonctionnalités.

Quoi de neuf?

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

Au lieu de cela, nous nous sommes concentrés sur l'affinage, la normalisation 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 auxquels les développeurs ont été confrontés. Et nous fournissons aux développeurs de meilleurs outils pour s'appuyer sur l'API et interagir avec elle, en commençant par une toute nouvelle 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 devoir connaître le sous-domaine d'un compte, il vous suffit de pointer toutes vos requêtes vers api.pagerduty.com et nous déterminerons le compte que vous souhaitez à partir de l'authentification. Fini le chemin racine /api/v1 non plus : 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 ce qui 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 décrit ce dont il s'agit. C'est votre guichet unique pour obtenir du 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 aux développeurs.

Notre Guide de migration de la version 1 à la version 2 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 bien plus encore. Commencez à effectuer des appels d'API directement à partir de la documentation avant d'écrire une seule ligne de code !

Si vous migrez le code API v1 existant, le Guide de migration de la version 1 à la version 2 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.

Cela étant dit, nous aimerions que vous commenciez à jouer avec l'API v2 dans votre environnement de test et que vous nous donniez votre avis ! équipe de support client primée est toujours sur le pont pour vous aider à vous mettre à niveau, ou vous pouvez contacter directement notre équipe de développeurs et de communauté à développeurs@pagerduty.com .

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