APIs Aren’t Just for Humans Anymore (Postman, HubSpot, & the Future of APIs)

En tant que développeur, j'ai quelques outils dans ma boîte à outils qui simplifient vraiment mon flux de travail. Aujourd'hui, je vais m'asseoir et discuter avec Anna, qui est une autre défenseur des développeurs chez HubSpot, et nous allons nous plonger dans l'un des outils qui me facilite tellement la vie lorsque je travaille avec des API. Alors, prenez un café et une collation et préparez-vous à découvrir comment Postman peut améliorer votre flux de travail de développement. Salut tout le monde ! Merci beaucoup de vous joindre à nous. Je suis Brie, défenseur des développeurs ici chez HubSpot. Je suis rejointe par l'incroyable Anna Seligson, qui est également développeur, défenseur des développeurs seniors chez HubSpot. Et une anecdote amusante à son sujet dont j'aimerais en savoir un peu plus, vous cultivez les plus belles fleurs. Oui, point, je sais, merci. oui, c'est ça, j'adore cultiver des fleurs coupées, et les fleurs coupées sont un peu différentes dans le sens où elles sont destinées à être cultivées pour être finalement des bouquets. Donc, oui, j'adore cultiver toutes sortes de variétés. Tournesol, zébaste, licentas. Je pourrais vous lancer un tas de noms au hasard, mais oui, mais au final, j'adore ça. Donc, oui, donc, si quelqu'un veut parler non seulement des API et de HubSpot, mais aussi des fleurs, je suis toujours partant. Donc. Oui, j'ai l'impression qu'il existe clairement un canal entre les personnes qui travaillent dans la technologie et celles qui veulent démarrer une ferme, devenir propriétaire ou faire des choses plus naturelles dans la vie. Ouais. J'ai l'impression que c'est comme vous, je pense que c'est parce que nous passons notre journée à utiliser notre cerveau et puis il y a cet aspect du genre à vouloir faire quelque chose de ses mains. Et je trouve ça très thérapeutique, très décompressant. Et c'est vrai, il y a beaucoup de gens dans la technologie qui, qu'ils soient jardiniers, ils ont peut-être. Je crois que je connais quelqu'un à Denver qui a une ferme laitière. Il y a beaucoup de propriétaires terriens. Nous sommes nombreux à aimer la technologie moderne dans notre quotidien, et quand on ne fait pas ça, à voir quelque chose qui nous ancre. Donc, la dualité. J'adore ça. J'adore le fait qu'on puisse faire tout ce qui est technologique et qu'ensuite, quand on est prêt, on puisse éteindre son ordinateur, aller travailler avec ses fleurs et sortir et profiter de tout ce qu'il y a à offrir. Ouais, exactement. Ouais, génial. Eh bien, je pourrais parler de fleurs et de toutes ces choses amusantes tous les jours, mais je suis vraiment impatient de parler avec vous de Postman, car vous êtes sans aucun doute un passionné de Postman dans notre équipe. Avant d'aller plus loin, pouvez-vous me dire en quelques mots ce qu'est Postman en tant qu'outil et pourquoi il est utile aux développeurs ? Oui, j'ai l'impression que si jamais vous voyez quelque chose en rapport avec HubSpot et Postman, c'est que j'ai probablement quelque chose à voir avec ça. Et la raison en est que Postman est un outil qui permet aux gens, et je ne veux pas dire uniquement aux développeurs, car je pense que l'interface utilisateur est suffisamment conviviale pour tout le monde, que vous travaillez davantage dans le domaine commercial ou administratif. Mais en gros, c'est une plateforme qui vous permet de tester des API, entre autres choses, mais en gros, ce qu'elle fait, c'est une interface utilisateur conviviale qui vous permet de tester des API REST. Donc, chaque fois que vous rencontrez une API HubSpot et que vous souhaitez la tester, par exemple, comme notre API Contact, et que vous souhaitez exécuter le point de terminaison Get-Get-All-Contact. Eh bien, Postman pourrait essentiellement vous aider à le faire en vous permettant de saisir le chemin d'accès à cette API. Et le chemin est essentiellement comme cette adresse web. Et ce qu'il va faire, c'est que vous allez lui fournir des autorisations, puis une fois que vous êtes en mesure d'autoriser les autorisations et d'avoir accès à ces données, vous pouvez exécuter et renvoyer ces données. Postman est donc un excellent moyen de voir à quoi ressemblent les données avec lesquelles vous essayez de travailler. Et je pense que c'est juste un excellent moyen de tester n'importe quel type d'API et de comprendre comment elle fonctionne, que vous soyez développeur ou non. Donc, absolument. Et je pense que c'est un outil pour les développeurs de tous niveaux. Je sais que lorsque j'ai commencé à apprendre à coder, j'étais plutôt un ingénieur front-end et les API peuvent être un peu effrayantes pour les développeurs lorsqu'ils débutent, car c'est l'une des premières choses réelles où l'on travaille avec des données. Donc, récupérer ces données était compliqué pour moi. Et je faisais beaucoup de ce travail dans la console avant de trouver un outil comme Postman. Et pour les RocketGet, c'est comme une chose, mais c'était très difficile à déboguer et à voir si le problème était mon code lui-même et qu'il ne récupérait pas les données, si le problème était le point de terminaison, si le problème était les entêtes. Il y a tellement de choses différentes avec les API que j'ignorais jusqu'à ce que je puisse les voir dans une interface utilisateur complète que Postman a en quelque sorte présentée pour vous et qui facilite grandement l'interaction. Oui, je suis tout à fait d'accord, et c'était c'était c'était c'était c'était c'était vous soulevez un bon point. Comme c'était quelque chose dont nous avons déjà parlé, ou il était comme si vous faisiez du développement front-end ou back-end, c'est quelque chose qui, je pense, permet aux développeurs de créer et d'accéder aux données et de comprendre, même du point de vue de l'interface utilisateur, comment c'est. Quoi, comment, quelles sont les données que vous voulez afficher ? Comme comprendre comment cela fonctionne. Et eux, ouais. Donc, Oui, je pense que c'est aussi comme on le disait, c'est utile pour les gens qui ne sont peut-être pas développeurs ou qui n'ont pas ce rôle de développeur, surtout quand on pense au fait que beaucoup d'outils exposent différentes fonctionnalités ou des fonctionnalités exclusives à leur API. Et la première qui me vient immédiatement à l'esprit, c'est que je sais qu'OpenAI propose souvent différents modèles ou différentes fonctionnalités spécifiquement pour une utilisation d'API. Donc, si vous voulez pouvoir accéder à ces fonctionnalités, mais que vous ne voulez pas avoir à vous embêter à créer votre propre application web pour pouvoir l'utiliser, Postman est un excellent moyen d'y accéder, et vous n'avez vraiment pas besoin de faire beaucoup de travail par vous-même pour pouvoir le faire. Ouais ? Exactement, et vous soulevez un bon point. Je pense que ce qui est formidable avec Postman, c'est que c'est un produit, c'est ce que nous appelons un produit destiné aux développeurs. Quel que soit votre secteur d'activité, que ce soit en rapport avec une API, que ce soit votre propre entreprise ou une entreprise externe, vous pouvez exploiter cet outil pour tout cela. Postman propose de nombreuses fonctionnalités différentes de nos jours. Je pense que c'est un outil radicalement différent de ce qu'il était il y a dix ans, lorsque j'ai commencé à l'utiliser en tant qu'ingénieur. Et maintenant, l'utiliser dans Devro, c'est une expérience tellement différente, je pense. Et ils l'ont améliorée. Personnellement, je pense qu'ils l'ont beaucoup améliorée parce qu'ils essaient essentiellement de s'adapter aux différentes façons dont nous développons et construisons les choses de nos jours. Absolument, et cela change beaucoup. Et je ne veux pas trop m'avancer, mais je sais que cela change beaucoup, surtout quand on pense non seulement à la transition de la manière dont nous l'utilisons en tant qu'ingénieur à celle de Devril, ou peut-être même à son utilisation dans une fonction différente, peut-être plus commerciale, mais aussi quand on pense à la manière dont l'IA émerge et à la manière dont cela change à la fois notre façon de construire et notre façon d'utiliser les API. Oui, exactement. Oui, je ne vais pas sauter de sujet, mais oui, nous en parlerons plus tard lorsqu'il s'agira de fonctionnalités. Absolument. Donc, quand on pense à Postman, on y pense beaucoup pour les tests, mais je sais qu'on peut aussi explorer les API, prototyper des choses et les intégrer dans ces domaines. En dehors des tests, pouvez-vous penser à des situations où cela pourrait être vraiment utile ? Oui. Donc, d'autres façons dont POST pourrait être utile en plus de tester vos API, c'est qu'il offre des moyens pour vous d'implémenter des scripts pour les tests. disons que vous voulez pouvoir tester une API. Vous construisez quelque chose en utilisant ces points de terminaison et vous voulez pouvoir appliquer une sorte de test unitaire à l'aide d'un SDK, vous pouvez réellement le faire. Et je pense que c'est vraiment utile. Je pense aussi qu'ils offrent des serveurs fictifs, ce qui peut être vraiment utile. Il y a beaucoup de débogage et de surveillance. Donc c'est possible. Vous pouvez réellement creuser un peu, et vous pouvez également, si vous proposez n'importe quel type, si vous construisez n'importe quel type, comme des collections ou les deux, d'un point de vue interne, comme si vous étiez un ingénieur utilisant Postman pour construire et concevoir vos API, par rapport à quelqu'un qui est du côté externe, ou vous exploitez, vous ne construisez pas et ne concevez pas. Vous testez et vous voulez construire un PC, dans tous les cas, ces outils peuvent être très utiles. Ils peuvent surveiller et vous dire comment cet API est exploité. Pourquoi rencontrons-nous autant de 400 ? Des choses comme ça, comme si ce point de terminaison d'API n'était pas utilisé comme il le devrait ? Je pense également que Postman peut être très utile pour toute forme de collaboration en matière de documentation. Ils proposent différents types d'espaces de travail, qui sont essentiellement ce que j'aime appeler un container, dans lequel vous pouvez avoir des actions de collecte personnalisées, qui sont en gros des points de terminaison individuels regroupés dans un dossier, puis vous pouvez ajouter des spécifications d'API. Nous avons également commencé à exploiter les flux chez HubSpot. Les flux sont une fonctionnalité qui ressemble à un outil low-code qui consiste à glisser-déposer, c'est-à-dire un canevas dans lequel vous pouvez enchaîner différentes requêtes d'API et créer un flux de travail ou une exécution globale. Et je pense que c'est vraiment utile, en particulier pour les personnes qui veulent juste élaborer un concept et dire, hé, est-ce que ça marcherait ? Puis pouvoir utiliser cette fonctionnalité de flux et voir comment cela fonctionnerait. Nous avons donc introduit un nouvel espace de travail, un espace de travail de flux pour HubSpot, et je pense que c'est vraiment utile, car lorsque nous avons créé les flux, nous voulions identifier les fonctions courantes, les solutions courantes que les développeurs fournissent aux clients HubSpot. Ce que je veux dire par là, c'est comment font-ils évoluer le compte HubSpot ? Comment lui permettent-ils de se développer ? Comment peuvent-ils implémenter une fonction personnalisée pour un processus métier ? Nous avons donc plusieurs flux différents avec différents cas d'utilisation où les développeurs peuvent essentiellement utiliser différents points de terminaison d'API HubSpot et avoir une sorte de flux de travail. Il y a donc tellement de choses. Et puis, eux, enfin, j'arrête de divaguer, mais ils proposent également de nombreux outils différents pour le développement de l'IA. Ils ont donc ce qu'ils appellent leur générateur d'agents d'IA. Et je pense que cela peut être très utile, car cela vous permet de créer un agent ou au moins un flux de travail orchestré. Et je pense que c'est vraiment bénéfique pour les gens, en particulier de nos jours, qui veulent comprendre comment quelque chose pourrait fonctionner. Et ils fournissent également un catalogue MCP, où, par exemple, HubSpot propose un serveur MCP. Vous pouvez y accéder sur HubSpot. Et ce qui est bien, c'est que vous pouvez comprendre quelles méthodes sont incluses dans ce serveur MCP, comment elles peuvent être utilisées, et cela vous permet de vous familiariser un peu plus avec lui. Il y a donc tellement d'aspects et de fonctionnalités différents dont je pense que nous pouvons vraiment bénéficier, tant du point de vue de l'entreprise que du développeur. Absolument. Et je pense que même en entendant toutes ces fonctionnalités, cela rejoint vraiment ce que vous disiez sur Postman qui a vraiment évolué au cours des dernières années et a rapidement augmenté le nombre d'outils qu'il propose aux développeurs pour améliorer leur flux de travail. et je pense que vous avez vraiment mis l'accent sur les collections et les espaces de travail. Et je sais que nous les utilisons beaucoup ici, en particulier dans le cadre de Devril. Et je voulais en fait vous poser une question parce que je sais que nous sommes allés à PostCon, j'ai l'impression que c'était hier pour être honnête, mais je sais que c'était il y a environ deux mois. Vous êtes allés à PostCon et vous avez eu l'occasion de faire une présentation sur la manière dont Postman nous permet de développer la défense des intérêts des développeurs ici chez HubSpot. Pouvez-vous me parler un peu de votre présentation et de votre expérience ? Oui, la présentation que j'ai faite à PostCon et pour ceux d'entre vous qui ne le savent pas, PostCon est en quelque sorte la conférence annuelle de Postman. Oui. Et cela permet essentiellement aux développeurs de se réunir et de partager la manière dont ils utilisent l'outil, tant d'un point de vue organisationnel qu'individuel. Mon exposé portait sur la manière dont nous exploitons réellement l'outil du point de vue de Devro. Pour ceux d'entre vous qui ne connaissent pas Devro, nous assurons les relations avec les développeurs. Ce que nous faisons, c'est que nous assurons en quelque sorte la liaison entre les développeurs qui utilisent notre produit et notre organisation interne. Que ce soit en ce qui concerne nos produits, nos fonctionnalités ou tout autre élément de ce genre, nous voulons pouvoir former les développeurs à l'utilisation de notre produit. Dans notre cas, HubSpot, comment créer sur HubSpot ? En tant qu'équipe, avec Bri et moi, nous créons du contenu pour former les gens à la manière de procéder ou, s'ils rencontrent des problèmes avec notre produit, comment pouvons-nous les atténuer et les aider à aller de l'avant ? Nous utilisons du contenu pour cela. Avec Postman, l'objectif était de démontrer que lorsque votre contenu est attrayant, il aide l'utilisateur final à l'utiliser avec beaucoup plus de succès. Pendant mon exposé, j'ai utilisé une activité parmi le public. J'ai présenté deux séries d'instructions. Les participants avaient chacun une enveloppe, une série d'instructions, puis un sac de pièces Lego. L'une de ces séries d'instructions expliquait comment construire ce Lego avec plusieurs formats. Il y avait une mise en forme visuelle, des instructions écrites pour la mise en forme, et même un aspect attrayant, comme l'utilisation de Lego, comme l'application Lego elle-même. Et puis il y a cet autre groupe, qui n'avait que des instructions sommaires et une seule image pour construire son Lego. Et bien sûr, dans mon cas, c'était des fleurs Lego. C'était vraiment intéressant à voir. Ce que je voulais dire, c'est que je voulais pouvoir démontrer en temps réel les avantages d'avoir du contenu avec lequel on peut interagir, et qui est également disponible dans différents formats, par rapport à quelque chose qui n'est qu'un texte écrit, et pouvoir démontrer les taux de réussite entre les deux groupes. Et c'est parce qu'avec les API HubSpot, nous avons, je ne sais même pas combien, mais c'est plus de 80 API. Et avec toutes ces API, vous savez, nous fournissons de la documentation. Nous fournissons des documents de référence sur la façon dont elles peuvent être utilisées. Mais ce n'est pas suffisant. Et c'est là que notre rôle entre en jeu dans Postman, où nous voulons pouvoir exploiter Postman afin que les développeurs puissent réellement interagir avec nos API. Ils peuvent réellement apprendre de nos API. Et si nous créons du contenu, que ce soit un article de blog ou une vidéo YouTube, nous avons un autre composant où les gens peuvent vraiment être plus impliqués, en particulier en ce qui concerne nos API. Et c'est comme ça que nous tirons parti de Postman. Et donc la présentation démontrait simplement le succès que nous avons eu au sein de notre équipe en tirant parti de Postman d'un point de vue du contenu, comme une autre ressource dans les relations avec les développeurs lorsque nous nous concentrons sur les API. Et c'est assez fou de voir à quel point nous avons progressé en créant ces espaces de travail public sur Postman et en disposant d'un emplacement centralisé pour toutes nos spécifications d'API, nos collections. Nous avons trois espaces de travail. Nous en avons un qui contient uniquement nos API publics. Nous en avons un deuxième qui est davantage adapté au cas d'utilisation des développeurs et qui est associé à un certain type de contenu, que ce soit un dépôt GitHub, un article de blog ou un webinaire. Et puis nous avons notre espace de travail de flux et nous fournissons simplement aux utilisateurs finaux, qui sont des développeurs externes, qui créent ces espaces de travail sur HubSpot. Cela leur offre un endroit central pour pouvoir mettre la main à la patte et s'approprier nos API au lieu de passer au crible la documentation et de se demander quelle est la prochaine étape. C'est donc sur cela que la discussion était axée, partager notre approche de notre contenu et le succès que nous avons eu, tout en fournissant et en exploitant des outils attrayants. J'ai vraiment adoré, et même les Legos mis à part, je les ai trouvés super mignons. Mais l'une des raisons pour lesquelles je l'aime vraiment, c'est que j'ai l'impression que cela rend cette technologie plus accessible. Chaque fois que nous ajoutons ou créons plusieurs éléments de contenu pour servir un concept ou une technologie, cela le rend accessible à davantage de personnes, car nous apprenons tous de différentes manières. J'ai déjà un peu parlé du fait que si vous me donnez un morceau de texte, je le lirai, mais ce n'est pas mon préféré, car je suis dyslexique. Donc, si vous me donnez une vidéo qui me convient mieux et qui me donne quelque chose que je peux réellement utiliser pour jouer avec les API, un outil qui est formaté autour de tout ce processus comme les collections Postman, en particulier comme l'espace de travail des API public où je n'ai pas affaire de configuration. Cela supprime simplement ces obstacles et me permet de me concentrer sur ce qui est important pour moi, à savoir la construction. Cela le rend donc plus accessible et cela peut également m'accélérer car je n'ai pas à faire tout le travail de base. Vous en avez fait une grande partie pour moi, oui ? Exactement, c'est le but. Nous voulons que ces choses soient accessibles et faciles à exploiter pour vous. Par exemple, je pense que dans le domaine de la technologie, il y a déjà tellement d'obstacles et il y a déjà tellement de choses à apprendre. Alors, pourquoi ne pas rendre cela plus facile ? C'est notre travail. Donc, eux, vous savez, et je pense que cela profite également au fait que, comme la plupart des défenseurs du développement, nous sommes aussi des ingénieurs. Nous avons traversé des moments difficiles, comme apprendre quelque chose, faire beaucoup d'essais et d'erreurs, et quand quelqu'un est capable de vous montrer quelque chose et de vous donner un outil pour le faire, c'est vraiment utile. Donc, absolument, et pour moi, l'empathie est un élément essentiel de la défense des développeurs, mais aussi de pouvoir défendre les développeurs, de les faire avancer plus rapidement et de pouvoir leur donner cette formation. C'est une grande partie de notre travail. Mais une autre partie de notre travail qui émerge ne consiste pas seulement à écrire du code, de la documentation ou des exemples pour les gens. Nous écrivons aussi maintenant toutes ces choses, mais aussi pour que l'IA ou les LLM puissent s'entraîner sur ces données afin d'aider d'autres personnes. Et c'est quelque chose qui change littéralement sous nos yeux. On a l'impression que c'est presque tous les jours. Oui, c'est vrai. Et j'ai l'impression que c'est quelque chose qui a été un grand enseignement à la postcon. C'est quelque chose que j'ai même partagé en interne chez HubSpot, c'est que nous, les développeurs, ne créons et ne concevons plus d'API pour les humains. C'est comme une toute nouvelle ère de l'IA, où nous faisons cela pour les agents. Et il y a juste une approche différente du développement et des outils que nous utilisons. Ils doivent pouvoir s'adapter à cela, nous aider à avancer et à travailler rapidement. C'est une tout autre chose, comme la vitesse du développement de nos jours, car les choses évoluent et deviennent de plus en plus adaptées à un cas d'utilisation spécifique ou simplement clarifiée. Et donc je pense que oui, de nos jours, les outils de développement sont tout simplement essentiels et constituent la manière dont nous fonctionnons en tant que société, nos entreprises et tout le reste. Il faut donc vraiment en tenir compte. Oh, bien sûr. Et je sais que vous avez mentionné quelques outils. Une fonctionnalité qui m'intéresse beaucoup, mais que je n'ai pas encore eu l'occasion de tester, c'est la possibilité offerte par Postman de créer son propre serveur MCP. Un nouveau concept que j'apprends encore au quotidien, c'est que nous sommes habitués, en tant que développeurs, à interagir avec des API pour créer nos applications, Mais nous entrons désormais dans un monde où les API communiquent avec d'autres API, et c'est ainsi qu'une grande partie du travail est également effectuée. Oui. Et ils ont cette fonctionnalité avec les MCP qui vous permet essentiellement de créer votre propre serveur MCP. Par exemple, disons qu'il existe des points de terminaison avec AWS et que nous voulons les utiliser avec HubSpot 8, comme certains points de terminaison. Nous pouvons créer un serveur MCP pour cela. C'est fou. C'est dingue. Oui. Donc, eux, donc, oui, c'est vraiment chouette de voir comment les choses évoluent, et même comme chez HubSpot, de voir comment nous évoluons également du point de vue de l'IA, en ce qui concerne les outils de développement que nous proposons et sur lesquels nous travaillons. Et c'est, oui, ça avance vite. Donc, oh, absolument. Et même en pensant à la façon dont les choses évoluent ici chez HubSpot. je sais que vous avez parlé d'un certain nombre d'outils que nous proposons aux développeurs ici chez HubSpot, mais je veux juste les approfondir un peu plus, car je pense qu'ils sont absolument essentiels pour quiconque envisage de développer sur HubSpot. Pouvez-vous m'en dire un peu plus sur certains espaces de travail et peut-être comment les gens peuvent les trouver s'ils sont intéressés par le développement sur HubSpot ? Oui, donc, si vous cherchez, si vous vous dites, hé, c'est génial, par où commencer ? nous avons une page de destination qui ressemble à développeur. HubSpot, Postman. E. Et nous maintenant essentiellement sur cette page de destination, vous trouverez l'accès à nos espaces de travail, à tout contenu pertinent, à nos collections les plus utilisées. E. Vous pouvez donc certainement commencer par là. Nous sommes également sur le réseau API de Postman. E. Donc si vous recherchez simplement HubSpot, vous trouverez toutes nos collections, notre serveur MCP, tous nos espaces de travail. E. Vous pouvez donc les trouver là-bas. et oui, et donc essentiellement comme avec les espaces de travail, disons que vous êtes un développeur, vous avez été chargé de trouver un moyen d'automatiser le système de tickets. Vous devez utiliser notre API de ticket. Vous feriez référence à l'espace de travail de l'API publique de HubSpot. Et ce que vous pourriez faire, c'est aller dans cet espace de travail et vous pourriez essentiellement, comme, bifurquer, vous pourriez bifurquer une collection. Il aura tous ses points de terminaison pour l'API de ticket. Et donc vous pouvez ensuite la bifurquer dans votre propre espace de travail personnel. Et juste pour que vous sachiez qu'il faut avoir un compte Postman. C'est gratuit. Vous pouvez donc l'intégrer à votre espace de travail personnel. Et vous pouvez ensuite faire ce que vous voulez. Vous pouvez tester des choses, vous pouvez écrire des choses. Il propose des générateurs de codes. Vous essayez peut-être de tester un point de terminaison d'API, mais vous devez maintenant implémenter une sorte de fonction avec ce point de terminaison en Python. Il vous aide à fournir cet extrait de code. Il y a donc tellement de choses qui, je pense, de ce point de vue, seraient vraiment utiles. Et puis, en ce qui concerne notre espace de travail de flux, vous pouvez y accéder de manière similaire. Vous pouvez cloner un espace de travail et chaque flux à sa propre collection et son propre environnement associé. Donc, tout type de variable d'environnement, et cette variable d'environnement sera généralement votre URL de base, votre jeton d'accès privé, et vous pourrez ensuite la personnaliser et l'exécuter dans votre propre espace de travail. Donc, si vous souhaitez modifier des éléments et les personnaliser pour les adapter à votre scénario spécifique, vous pouvez le faire. Donc oui. J'adore ça. J'ai beaucoup appris de vous, bien sûr, mais l'une des choses que j'ai apprises à la PostCon, c'était les flux. Vous avez été incroyables et vous nous les avez présentés, car nous avions un stand où nous avons pu parler à de nombreuses personnes différentes qui utilisent Postman. Certaines personnes connaissaient également HubSpot. C'était donc toujours des conversations très intéressantes. Mais en tant que personne très visuelle, j'aime beaucoup les flux, car ils vous donnent une vision très claire du fonctionnement de processus spécifiques. Par exemple, des choses comme OOTH, qui peuvent être une tâche très compliquée et un flux très compliqué, faute de meilleurs mots. Donc, pouvoir voir le flux OOTH que vous avez créé vous explique exactement comment les jetons sont générés et toutes ces différentes branches. Et je me souviens même que ce n'est pas seulement un générateur LOW, NOOD. Vous pouvez également importer vos propres blocs de code et exécuter des transformations sur les données que vous obtenez. Cela permet donc de voir très facilement ce qui se passe exactement, comme tous ces différents éléments se déplacent ensemble et où vont et se déplacent les données. Ouais. Exact. Non. Exactement. Je suis content que vous ayez soulevé ce point. Ouais. Avec les flux, c'est un peu comme une mini-application, car ils ont tous ces différents blocs glissés-déposés, et il y en a qui vous donnent des instructions IF, vous pouvez parcourir les données en boucle. Il y a un bloc d'évaluation que vous pouvez utiliser. Ils ont leur propre langage personnalisé appelé FQL, puis vous pouvez utiliser TypeScript. J'ai donc définitivement révisé mon TypeScript. Mais en gros, vous pouvez voir cette logique, comprendre ce qu'elle fait. Vous pouvez même ajouter de la documentation. J'ai fait de mon mieux pour expliquer ce que fait chaque bloc. Et c'est vraiment utile. Et puis, je pense que cela peut être comparé à des scripts, en particulier avec Postman. Dans chaque requête que vous faites, vous pouvez ajouter un script de pré-requête et un script de post-requête. Je pense qu'en supprimant cette logique et en l'utilisant avec des blocs de code dans des workflows, cela vous donne vraiment, comme vous le disiez, cette accessibilité visuelle pour comprendre ce qui se passe. Je pense que c'est également très utile pour les personnes qui voient l'un de ces flux, dont l'un était un workflow de création de factures. Disons que quelqu'un se dit, oh, j'ai besoin de ça. En fait, j'ai besoin d'utiliser quelque chose comme ça. Ils pourraient le partager avec leur développeur ou quelqu'un de plus technique dans leur équipe, et leur demander, hé, est-ce que ça a du sens pour nous ? Pourrions-nous utiliser ça ? Ou pourrions-nous peut-être le créer pour la production ? Et vous savez, vous pouvez travailler avec quelqu'un en fait. Je pense que cela facilite également les conversations entre des personnes moins techniques et plus techniques, et qu'elles peuvent être d'accord et comprendre les besoins de chacun. Je pense donc qu'il y a aussi un avantage. Absolument. Et c'est sûr que je ne sais pas comment je travaillais avec les API avant, mais j'ai découvert Postman, honnêtement. J'utilisais juste les journaux de la console et je les plaçais un peu partout. C'était très aléatoire, très aléatoire. Mais c'est définitivement un outil que je recommande à tous les développeurs d'avoir dans leur petite boîte à outils. Mais en termes de réflexion, je pense aussi à l'utiliser comme outil en général pour travailler avec les API, car je sais que je n'étais certainement pas un expert venant du monde du front-end et que vous étiez plutôt un expert en tant qu'ingénieur logiciel back-end. Existe-t-il des outils ou des conseils que vous pourriez fournir, à moi ou à quiconque nous regarde, sur les meilleures pratiques lors de l'utilisation ou de la mise en œuvre des API ? Oui, merci. Oui. Donc, je suppose que ce que je suggérerais, et cela peut s'appliquer à la fois à n'importe quelle API et au API HubSpot. Tout d'abord, si un service, une API propose un point de terminaison par lot, je suggère fortement de l'exploiter. Et pourquoi ? Parce que, disons, vous devez exploiter une grande quantité de données. Un point de terminaison par lot vous permet de le faire avec une seule requête, par opposition à dix requêtes, comme dix requêtes GET ou PU, etc. Je pense donc que c'est vraiment important et que cela vous aide également à limiter le risque d'atteindre vos limites de débit. Les limites de débit sont essentiellement une limite imposée au nombre de requêtes que vous pouvez effectuer par jour. Et c'est souvent le cas lorsque vous utilisez une API dont vous n'êtes pas propriétaire du serveur. Donc, si vous utilisez les API HubSpot, cela affecte notre serveur. Nous n'attribuons donc que certaines limites de débit et limites auxquelles vous pouvez effectuer ces appels. Et plus particulièrement, je sais que pour nos applications OOTH, eux, ce qui, je suppose, ressemble beaucoup à un truc de HubSpot, mais nous proposons actuellement des applications publiques et privées, et les applications publiques utilisent un jeton OOTH, puis il y a des jetons d'accès privés. Et donc pour les applications OTH en particulier, vous ne pouvez faire des requêtes que toutes les 10 secondes, alors que la façon dont nous traitons les jetons d'accès privés, c'est un peu comme si ça dépendait. Il y a d'autres spécificités qui s'appliquent à cela. Donc oui, je dirais que chaque fois que vous avez l'opportunité d'exploiter un point de terminaison par l'eau pour une grande quantité de données, faites-le. Et puis j'imagine que cela se répercute sur la façon d'utiliser les autorisations. c'est quelque chose que j'ai aussi appris à mes dépens, parce que je pense que les gens OAS peuvent être intimidants, mais... Je ne veux pas dire que ce n'est pas le cas, car cela le rejette, mais je pense qu'il est vraiment important de comprendre son objectif et la manière dont il est traité. En plus d'un jeton d'accès privé, vous avez essentiellement besoin de ces jetons pour pouvoir accéder à des données spécifiques, et chacun de ces jetons a un certain nombre de ce que nous appelons des « étendues », les autorisations qui s'appliquent essentiellement à ces jetons. Donc, par exemple, si vous souhaitez collecter toutes vos données de contacts, d'entreprises, de transactions et de tickets, mais que vous devez également obtenir, par exemple, une autre sorte de données d'objets personnalisés, mais que vous n'appliquez pas ces étendues à ce jeton, vous ne pourrez pas accéder à ces données. Et c'est quelque chose de vraiment important, comprendre que lorsque vous définissez vos autorisations avec ces jetons, vous le faites de manière intelligente, en tenant compte de tout ce dont vous avez besoin, mais vous ne voulez pas non plus en demander trop, car cela pose des problèmes. Donc, eux, oui, je pense que c'est vraiment important. Et généralement, avec un jeton OOTH, vous allez utiliser un ID client, un secret client, eux, et vous pouvez ensuite utiliser essentiellement le jeton d'accès que vous obtenez lorsque vous lancez le processus OOTH pour demander des jetons d'actualisation. et c'est globalement une expérience plus sûre pour vous, vos utilisateurs finaux, etc. Et heureusement, chez HubSpot, nous avons établi un bon partenariat avec GitHub, aussi un jeton, qu'il soit OTH, privé, etc. Il y a des jetons liés, par exemple, à nos emails marketing, il y a, je crois, une clé API développeur, et j'oublie certains des autres jetons que nous proposons, mais si GitHub est capable d'identifier les jetons exposés, nous les désactiverons pour vous. Et c'est vraiment très important. Et quand vous développez, vous devez utiliser un environnement comme une sorte de variable d'environnement. Vous ne voulez pas coder en dur vos jetons dans votre base de code, ou que ce soit qui pourrait être vérifié dans ce dépôt. Je pense que nous avons probablement tous été coupables de cela. Mais oui, c'est un grand non non. un énorme non. Ouais, parce que vous êtes sur le point de vous faire pirater. Donc j'espère que non, mais ouais. C'est vraiment important et je pense que ce sont des choses que les gens doivent vraiment mettre en pratique, comme en être conscient et s'assurer de faire preuve de diligence raisonnable pour protéger leurs données et d'être intelligents dans la manière dont ils essaient d'y accéder. Absolument. Et merci beaucoup pour ces conseils, car je sais que même si nous exploitons davantage l'IA pour nous aider à écrire du code et à le générer, ce genre de choses ne sont pas vraiment des leçons que l'on apprend en générant simplement du code. Ce sont certainement des leçons que, comme vous l'avez dit, vous avez dû apprendre à vos dépens. Je peux vous dire personnellement que j'ai accidentellement minimisé une clé d'accès privée ou quelque chose comme ça. Je n'en suis pas fière, d'ailleurs, mais c'est arrivé. Ouais, ouais. Utilisez votre getignorfilputv. Oui. Ne faites pas ça. Non. Ce n'est pas une bonne chose et ce n'est pas facile à réparer non plus. Donc, si une fois l'erreur est commise, je vous promets que vous en tirerez certainement une leçon. Ouais, ouais, sérieusement, alors, ouais. Et pour OAT en particulier, si vous souhaitez en savoir plus, car j'ai justement fait une vidéo à ce sujet il n'y a pas si longtemps sur la chaîne YouTube, j'adore la façon dont vous l'avez expliqué et l'une des façons dont j'ai pensé à cela était un voiturier numérique. En particulier lorsque vous réfléchissez aux différentes portées ou autorisations, vous voulez donner au voiturier la clé de votre voiture. Vous ne voulez pas lui donner tout votre trousseau de clés avec accès à votre maison, à votre stockage ou à tout autre objet que vous possédez. Vous voulez être très précis avec ses autorisations et ne pas vraiment en fournir trop. Ouais, non, c'est une excellente analogie, j'adore ça. Et malheureusement, j'ai juste commencé à réaliser que je devrais probablement enlever toutes mes clés et voici ma clé de voiture. N'est-ce pas ? Vous savez quoi ? Je n'ai même pas beaucoup de clés de voiture. Je n'ai littéralement qu'une seule clé de voiture. Je n'ai même pas vraiment de clé de maison, mais c'est tout l'ère du numérique avec les serrures numériques et ce genre de choses. Je me suis dit, waouh, vous avez une maison intelligente. Cool ! J'aimerais bien. Oh mon dieu ! Mais avant de conclure, avez-vous des derniers conseils, des points forts ou des connaissances générales à partager avec les développeurs HubSpot ou la communauté des développeurs au sens large ? Oui, j'encourage toujours les gens à consulter notre documentation pour les développeurs. J'ai l'impression qu'il y a plus d'informations que les gens ne le pensent. Et donc, en tant que personne chez HubSpot depuis seulement 3 ans, cela m'a beaucoup appris. Et c'est aussi très utile d'entrer en contact avec les membres de notre communauté, de comprendre peut-être quelques petites nuances et de se faire un peu de bien. Si quelque chose semble compliqué, c'est probablement le cas. Ce n'est pas que vous. Et je pense qu'il est important de s'impliquer sur notre forum communautaire et notre chaîne Slack. De partager vos questions, que ce soit sur LinkedIn. Et nous voulons aussi savoir, car nous voulons que tout contenu que nous créons soit pertinent, utile et utile. Donc s'il y a des choses pour lesquelles il y a des lacunes en termes de connaissances et pour lesquelles nous pouvons fournir du contenu, faites-le nous savoir. Mais oui, je commencerai certainement par notre page d'accueil pour les développeurs sur laquelle vous pouvez consulter des ressources. Mais nous avons également nos documents API et ils évoluent et s'améliorent constamment et je suis juste impatient de voir que chaque année, j'ai l'impression que nous faisons beaucoup d'améliorations. Donc, j'en suis heureux et je pense que les gens devraient vraiment y jeter un oeil. Absolument. Je tiens simplement à vous remercier beaucoup de vous joindre à moi aujourd'hui pour parler des API, de Postman et des meilleures pratiques générales pour nos développeurs ici chez HubSpot et des façons dont nous pouvons améliorer le processus de développement HubSpot. Je vais laisser des liens dans la description vers tout ce dont nous avons parlé aujourd'hui et même quelques autres choses. Alors, n'oubliez pas de consulter le lien ci-dessous et assurez-vous d'être abonné à notre chaîne YouTube HubSpot Developer pour des vidéos comme celle-ci et bien plus encore. Et à la prochaine, merci beaucoup de nous rejoindre, Anna.