Les mises à jour de juin rendent les workflows API plus simples à automatiser et plus fiables au quotidien : CLI prête pour les agents IA, importations plus propres, rafraîchissement automatique OAuth 2.0 et plusieurs améliorations issues des retours utilisateurs.
Cette version cible les frictions courantes des équipes API : donner aux agents IA un accès structuré aux ressources réelles du projet, réduire le nettoyage après import, éviter les interruptions OAuth et accélérer les petites tâches répétitives de test et de configuration.
Voici les changements à intégrer dans vos workflows.
Nouvelles mises à jour
Apidog CLI prend en charge les workflows API alimentés par l’IA
Apidog CLI devient une couche d’exécution pour les workflows API assistés par IA.
L’objectif n’est pas seulement d’exécuter des commandes manuellement. La CLI permet aussi à des agents IA de travailler avec des ressources Apidog réelles de façon structurée : lecture des ressources du projet, écriture de modifications, validation d’opérations, export de données et exécution de workflows de test.
Concrètement, vous pouvez l’utiliser comme point d’entrée pour :
- permettre à un agent IA d’opérer sur les ressources d’un projet Apidog ;
- exécuter des cas de test ;
- construire des scénarios qui référencent des endpoints, des cas de test ou d’autres scénarios ;
- exporter des données au format natif ou OpenAPI avec un contrôle de portée plus précis.
Un workflow typique peut ressembler à ceci :
1. L’agent IA lit les ressources du projet Apidog.
2. Il propose une modification structurée.
3. La CLI valide l’opération ou exécute les tests concernés.
4. Les résultats sont utilisés pour confirmer ou corriger la modification.
5. Les données nécessaires sont exportées au format natif ou OpenAPI.
Associée aux Apidog Skills, la CLI donne aux agents IA des consignes plus précises et des limites d’exécution plus sûres. Les agents peuvent mieux comprendre comment utiliser les ressources Apidog, valider les changements générés avant de les réécrire, puis accomplir des tâches API avec moins d’incertitude.
Pensez à la CLI comme au pont entre les instructions IA en langage naturel et les opérations structurées dans un projet Apidog.
Améliorations de l’importation et de l’exportation
Cette version améliore plusieurs workflows d’import/export, notamment pour les équipes qui migrent depuis Postman ou maintiennent des définitions OpenAPI et Swagger.
Import depuis Postman
Lors de l’import via l’API Postman, Apidog peut désormais supprimer les espaces dans les noms de variables.
Cela réduit le nettoyage manuel après import et évite les problèmes liés aux variables difficiles à réutiliser dans les requêtes, tests ou environnements.
Exemple de problème évité :
Avant import :
base url
access token
Après nettoyage :
baseurl
accesstoken
Lors de l’import d’espaces de travail via l’API Postman, Apidog peut aussi renommer les espaces de travail ambigus comme My Workspace en fonction du créateur de l’espace de travail.
C’est utile lorsque plusieurs workspaces sont importés dans un même projet : les données sont plus faciles à identifier, trier et affecter à la bonne équipe.
Import/export OpenAPI et Swagger
L’import/export OpenAPI et Swagger prend désormais en charge :
- les paramètres de type objet ;
- les paramètres de type référence.
Cela aide à préserver des spécifications API plus riches sans devoir corriger manuellement les schémas après migration.
Exemple de structure mieux préservée :
parameters:
- name: filter
in: query
schema:
type: object
properties:
status:
type: string
owner:
type: string
| Avant | Maintenant |
|---|---|
| Les variables importées pouvaient nécessiter un nettoyage manuel. Plusieurs espaces de travail importés pouvaient avoir des noms confus. Les paramètres OpenAPI complexes pouvaient nécessiter des ajustements supplémentaires après l’import/export. |
Les importations via l’API Postman peuvent supprimer les espaces des noms de variables. Les noms d’espaces de travail ambigus peuvent être renommés pour une identification plus facile. L’import/export OpenAPI/Swagger prend en charge les paramètres de type objet et de type référence. |
OAuth 2.0 prend désormais en charge le rafraîchissement automatique des jetons
L’authentification OAuth 2.0 prend maintenant en charge le rafraîchissement automatique des jetons.
Lorsqu’un jeton d’accès est proche de l’expiration ou déjà expiré, Apidog peut le rafraîchir automatiquement. Vous pouvez donc continuer à envoyer vos requêtes sans vous réauthentifier manuellement ni copier un nouveau jeton.
Cela simplifie les sessions de débogage sur des API protégées par OAuth.
Workflow recommandé :
1. Configurez votre authentification OAuth 2.0.
2. Exécutez vos requêtes protégées.
3. Laissez Apidog gérer le rafraîchissement lorsque le jeton expire.
4. Continuez vos tests sans interrompre le flux de requêtes.
Cela réduit les interruptions d’authentification pendant le débogage, les tests et la validation répétée des requêtes API.
Améliorations basées sur les retours utilisateurs
Meilleure compatibilité client MCP
Apidog améliore la compatibilité du client MCP et peut analyser plus fiablement des schémas non standard.
C’est utile lorsque vous vous connectez à des serveurs ou outils MCP dont la sortie de schéma ne respecte pas strictement les formats attendus. Au lieu d’échouer trop tôt sur une variation de schéma, Apidog peut traiter davantage de réponses MCP réelles.
Résultat : intégration et débogage d’outils MCP plus fluides.
Recherche d’étapes statiques par nom dans les suites de tests
Lors de l’ajout d’étapes statiques à une suite de tests, vous pouvez désormais rechercher par nom.
Pour les projets contenant beaucoup d’endpoints, de cas de test ou de scénarios, cela évite de parcourir de longues listes manuellement.
Utilisation pratique :
1. Ouvrez votre suite de tests.
2. Ajoutez une étape statique.
3. Recherchez l’étape par nom.
4. Sélectionnez l’endpoint, le cas de test ou le scénario souhaité.
Les tâches planifiées ajoutent une option “Toutes les 8 heures”
Les tâches planifiées incluent maintenant l’intervalle Toutes les 8 heures.
Cet intervalle peut être utilisé pour :
- des tests automatisés récurrents ;
- des vérifications proches d’un monitoring léger ;
- des validations périodiques d’API ;
- des suites de non-régression exécutées plusieurs fois par jour.
L’application Web Apidog prend en charge la configuration des en-têtes générés automatiquement
L’application Web Apidog permet désormais de configurer les en-têtes générés automatiquement.
Cela donne plus de contrôle sur le comportement des requêtes depuis le navigateur et aide à aligner les en-têtes générés avec les conventions de l’équipe ou du projet.
Exemples de cas où c’est utile :
- Harmoniser les en-têtes utilisés par plusieurs membres de l’équipe.
- Adapter les requêtes aux exigences d’un environnement spécifique.
- Réduire les modifications manuelles avant l’envoi d’une requête.
Corrections de bugs et améliorations mineures
Cette version inclut aussi plusieurs correctifs et améliorations :
- Amélioration des performances lors de la sélection de scénarios de test volumineux pour les branches enfants, réduisant le risque d’erreurs de temporisation.
- Les listes de branches de sprint et de branches générales prennent désormais en charge l’affichage des identifiants de branche et leur copie.
- Un message plus convivial s’affiche lorsque macOS ne peut pas envoyer de requêtes intranet.
- Correction d’un problème où les URL de base de service n’étaient pas importées et les endpoints n’étaient pas liés au service spécifié lors de la réimportation de données Apidog dans un nouveau module.
- Correction d’un problème où l’authentification OAuth 1.0 configurée pour être ajoutée à l’en-tête de requête n’était pas réellement ajoutée à l’en-tête.
- Correction d’un problème où le code de requête d’endpoint généré ne fonctionnait pas correctement lorsque Basic Auth utilisait des variables chinoises.
- Correction d’un problème où le code de requête généré utilisait incorrectement HTTPS lorsque l’endpoint utilisait HTTP.
- Correction d’un problème où l’exécution de scénarios CLI pouvait signaler
Jeton inattendulorsqu’une étape de scénario référençait un corps de réponse au format brut. - Correction d’un problème où les détails du rapport de test apparaissaient toujours comme étant en cours d’exécution après l’arrêt anormal d’un scénario de test automatisé.
- Correction d’un problème où le rapport correspondant n’était pas affiché dans la liste des rapports de test après l’exécution de cas de scénario dans le dossier racine.
- Correction d’un problème où le rafraîchissement de l’application Web Apidog ramenait automatiquement le projet à la branche principale.
- Correction d’un problème où les options de filtre de balise n’avaient pas de contenu lors de l’importation de branche et lors de l’insertion d’endpoints en Markdown.
- Correction d’un problème où les services non par défaut étaient ajoutés de manière répétée lors de l’importation de fichiers Apidog avec plusieurs modules et services.
- Correction d’un problème où les balises de document Markdown n’étaient pas importées correctement lors de l’importation de données Apidog.
- Correction d’un problème où des conflits étaient toujours affichés après la fusion d’endpoints dans la branche principale dans certains cas.
- Correction d’un problème où des erreurs frontend pouvaient survenir dans certains cas lors du débogage des endpoints SSE.
- Correction d’un problème où les statistiques de projet On-Premises ne comptaient que les données du module par défaut.
- Correction d’un problème où l’importation d’un fichier Apidog multi-module depuis la page des détails de l’équipe importait incorrectement les endpoints dans le module par défaut.
- Correction d’un problème où les modifications disparaissaient dans certains cas après la soumission des modifications.
- Correction d’un problème où un message d’erreur incorrect était affiché dans le flux de vérification des e-mails lors du changement de mots de passe.
Ce que cela change pour vos workflows API
Ces mises à jour rendent Apidog plus utile dans les workflows qui combinent développeurs, agents IA, spécifications API et tests automatisés.
| Domaine | Ce qui s’améliore | Pourquoi c’est important |
|---|---|---|
| Workflows CLI alimentés par l’IA | La CLI peut aider les agents IA à opérer sur les ressources réelles du projet Apidog, exécuter des cas de test, référencer des actifs existants et contrôler les exports plus précisément. | Les agents IA peuvent travailler avec un contexte projet structuré au lieu de deviner à partir d’informations non structurées. |
| Importation et exportation | Les imports via l’API Postman peuvent nettoyer les noms de variables et clarifier les noms d’espaces de travail. L’import/export OpenAPI/Swagger prend en charge les paramètres de type objet et de type référence. | Moins de nettoyage après migration et un échange de spécifications API plus complet. |
| Authentification | Les jetons OAuth 2.0 peuvent se rafraîchir automatiquement. | Moins d’interruptions pendant le débogage et les tests d’API. |
| Compatibilité MCP | Le client MCP peut analyser davantage de schémas non standard. | Meilleure compatibilité avec les outils et serveurs MCP réels. |
| Workflows de test | Les étapes statiques sont plus faciles à trouver et les tâches planifiées prennent en charge un intervalle supplémentaire de 8 heures. | Configuration plus rapide des suites de tests et exécution récurrente plus flexible. |
| Configuration Web | Les en-têtes générés automatiquement peuvent être configurés dans l’application Web Apidog. | Plus de contrôle sur le comportement des requêtes dans les workflows navigateur. |
En pratique, le chemin opérationnel devient plus propre :
Agents IA -> meilleur contexte projet
Imports -> moins de nettoyage manuel
OAuth 2.0 -> moins d’interruptions
Tests planifiés -> plus de flexibilité
Application Web -> meilleur contrôle des requêtes
Rejoignez la conversation
Connectez-vous avec d’autres ingénieurs API et l’équipe Apidog :
- Rejoignez notre communauté Discord pour des discussions et un support en temps réel.
- Participez à notre communauté Slack pour des conversations techniques.
- Suivez-nous sur X (Twitter) pour les dernières mises à jour.
P.S. Pour tous les détails sur les mises à jour, consultez le Journal des modifications Apidog.
Cordialement,
L’équipe Apidog
Top comments (0)