Avec Apidog 2.8.47 à 2.8.50, les mises à jour de ce mois-ci facilitent la maintenance de l'automatisation des API, l'intégration des dépôts et la documentation des API, des importations modulaires via la CLI et la création de cas de débogage aux connexions Bitbucket Cloud, GitLab auto-hébergé et aux schémas publiés à partir des sous-sites Docs.
Cette version vise à simplifier la configuration de l'automatisation et de la collaboration Git.
Les mises à jour d'Apidog de septembre se concentrent sur les points où les équipes perdent souvent du temps : la gestion de grandes structures de projet à partir de scripts ou de flux de travail IA, l'importation d'actifs API dans le bon module, la création d'actifs de test sans quitter le terminal, et la connexion de fournisseurs Git existants sans modifier la façon dont les équipes travaillent déjà.
En bref :
- Automatisation Apidog CLI : gérez les modules de projet, importez des données API multi-formats par module et créez des cas de test de débogage à partir de fichiers de configuration.
- Intégrations de dépôts Git : ajoutez des connexions Bitbucket Cloud et GitLab On-Prem aux flux de travail d'importation/exportation de projets.
- Utilisabilité quotidienne : gestion plus claire des URL, meilleur filtrage des rapports de test, complétion des variables de données de test et liste de projets plus rapide.
- Visibilité Docs et performances : les sous-sites Docs publient des schémas, et les tests de performance signalent les temps de réponse P95 et P99.
🤖 Apidog CLI pour l'automatisation des API et les flux de travail IA
L'interface de ligne de commande (CLI) d'Apidog est déjà devenue un point d'entrée utile pour les exécutions de tests CI et l'automatisation. Cette version l'étend plus tôt dans le flux de travail : les équipes peuvent gérer la structure du projet, importer des données dans le bon module et créer des cas de débogage avant d'exécuter les tests.
Gérer les modules de projet depuis la CLI
L'interface CLI d'Apidog peut désormais interroger, créer, mettre à jour et supprimer des modules de projet.
C'est utile lorsque la structure du module doit être modifiée dans le cadre d'un flux de travail automatisé. Après une opération d'écriture, la CLI renvoie un JSON structuré incluant l'moduleId, afin que les scripts et les agents puissent transmettre l'identifiant aux étapes ultérieures d'importation, de test ou de maintenance au lieu de demander à quelqu'un de le copier depuis l'interface utilisateur.
Cela fait de la gestion des modules une partie de la même boucle reproductible que les tests d'API et l'automatisation CI.
Importer des données API dans un module sélectionné
La commande d'importation CLI a été refactorisée pour réutiliser les capacités d'analyse du client Apidog. Vous pouvez importer des données API depuis des sources prises en charge dans un module de projet spécifié au lieu de créer d'abord les données dans l'interface utilisateur et de les déplacer ensuite.
Pour les migrations plus importantes, les résultats d'importation incluent le nombre d'éléments ajoutés, mis à jour, ignorés et supprimés. Cela facilite la tâche des scripts, des tâches CI et des agents IA pour vérifier ce qui s'est passé avant de passer à l'étape suivante.
C'est particulièrement utile lorsque plusieurs formats doivent aboutir dans la même structure de projet avec moins d'étapes de nettoyage manuel.
Créer des cas de test de débogage à partir de la configuration
Les utilisateurs de la CLI peuvent désormais créer des cas de test de débogage d'interface à partir de fichiers de configuration. Une configuration peut définir le nom du cas, l'API cible, les paramètres de requête, le corps de la requête, l'authentification, les pré-processeurs, les post-processeurs et la validation de la réponse.
Après sa création, le cas de débogage peut être ouvert, modifié et exécuté dans Apidog comme tout autre cas de débogage. C'est utile lorsque l'automatisation ou un agent prépare l'actif de test initial, mais qu'un développeur souhaite toujours l'inspecter et le raffiner visuellement.
Ensemble, la gestion des modules, les importations structurées et la création de cas de débogage réduisent le travail manuel pour les scripts locaux, les pipelines CI/CD et les flux de travail assistés par l'IA.
Si vous avez déjà Apidog CLI installé, mettez-le à jour avant d'utiliser les nouvelles fonctionnalités :
npm install -g apidog-cli@latestConsultez la documentation de l'Apidog CLI pour la dernière référence des commandes.
🔗 Intégrations de dépôts Git
Septembre étend également l'importation/exportation basée sur Git à deux environnements de dépôts courants.
Bitbucket Cloud
L'importation et l'exportation de projets prennent désormais en charge les dépôts Bitbucket Cloud. Les équipes utilisant déjà Bitbucket Cloud peuvent conserver leurs dépôts existants dans le flux de travail au lieu de déplacer les actifs API vers une autre plateforme Git.
GitLab On-Prem
Les organisations peuvent configurer une instance GitLab On-Prem dans Apidog SaaS et l'utiliser dans les flux de travail de dépôts Git pris en charge. Chaque organisation gère sa propre connexion de manière indépendante, afin que les équipes puissent continuer à utiliser leur configuration GitLab auto-hébergée existante.
Avant de vous connecter, assurez-vous que l'adresse de l'instance GitLab et l'environnement réseau répondent aux exigences de connexion.
⚙️ Améliorations quotidiennes
La version répond également aux retours fréquents du travail quotidien sur les API.
Les URL complètes ne sont plus en conflit avec le chemin d'environnement
Lors de la création ou de la modification d'une API HTTP, la saisie d'une URL complète commençant par http:// ou https:// masque désormais immédiatement le chemin d'environnement. La modification de la valeur pour un chemin relatif restaure le chemin d'environnement.
Cela élimine la confusion de voir une URL complète et un chemin d'environnement simultanément, et supprime la nécessité de sauvegarder d'abord pour observer le comportement.
Filtrage plus utile des rapports de test
Les listes de rapports de test prennent désormais en charge le filtrage par exécuteur et source d'exécution. Des champs d'affichage associés ont également été ajoutés, ce qui facilite la réduction d'une longue liste de rapports et la comparaison des enregistrements récents provenant de différentes origines.
Les variables de données de test apparaissent dans la complétion
Les variables de données de test existantes apparaissent désormais à la fois dans la complétion de code et la complétion de valeurs dynamiques. Lors de la rédaction de requêtes ou de tests, vous pouvez rechercher et sélectionner la variable directement au lieu de revenir à la liste des variables pour copier son nom.
Listes de projets plus rapides
Apidog a optimisé le temps de réponse de l'API de liste de projets. Les listes de projets se chargent plus rapidement lors de l'entrée dans un espace de travail ou de la localisation d'un projet, réduisant ainsi le temps d'attente lors des navigations et des commutations fréquentes.
✨ Également dans cette version
Trois changements complètent le mois, couvrant la documentation, les tests de performance et la configuration de projets axés sur les spécifications.
Publier des schémas depuis les sous-sites Docs
Les sous-sites d'Apidog Docs peuvent désormais publier des schémas à côté des points d'extrémité, afin que les lecteurs d'un site publié puissent les voir directement sans avoir à revenir au site principal. Les sous-sites d'entreprise peuvent activer cette fonctionnalité eux-mêmes.
Temps de réponse P95 et P99 dans les tests de performance
Les résultats des tests de performance signalent désormais les temps de réponse P95 et P99 en plus des métriques existantes. Les percentiles décrivent la "traîne lente" que les moyennes masquent, ce qui est généralement la partie d'une API que les utilisateurs remarquent réellement.
Configuration de projet en mode Spec et importation OpenAPI
Les projets en mode Spec s'ouvrent désormais sur un état vide plus clair, avec les points d'entrée d'importation et de création OpenAPI directement affichés, de sorte qu'un projet axé sur les spécifications peut démarrer sans chercher le moyen d'y parvenir.
🛠️ Correctifs et améliorations supplémentaires
Ce cycle inclut également les correctifs et modifications mineures suivantes :
- Amélioration de l'affichage de l'état d'essai et des actions dans la fenêtre principale et la barre d'onglets.
- Amélioration de l'affichage des invitations en attente dans les listes des membres de l'organisation et de l'équipe.
- Correction d'un problème où les variables Basic Auth dans le code de requête généré n'étaient pas développées et étaient encodées directement en Base64.
- Correction d'un problème où la modification d'un onglet n'étendait pas les champs de modèle de données combinés référencés utilisant
allOf. - Correction d'un problème où les références API inter-projets aux modèles de données étaient incorrectes après le clonage ou la copie d'un projet.
- Correction d'un problème où les cas de débogage créés par la CLI affichaient le type d'authentification comme "Aucune Auth" sur le client Web et n'appliquaient pas l'authentification.
- Correction d'un problème où les définitions
$refde réponse OpenAPI étaient silencieusement ignorées lors de l'importation CLI. - Correction d'un problème où les métadonnées de pagination de la liste des rapports renvoyaient des valeurs
pageSizeetpageIndexincorrectes. - Correction d'un problème où la génération de rapports de test JUnit et HTML entraînait un rapport JUnit contenant uniquement le résultat du dernier cas de test.
- Correction d'un problème où le menu déroulant d'environnement ne s'ouvrait pas lors du changement d'environnements d'URL dans les tests API uniques.
- Ajout de la prise en charge de la désactivation de l'entrée de récompense d'invitation sur la page d'accueil via la politique d'entreprise.
Pour la liste complète, élément par élément, consultez le Journal des modifications d'Apidog.
🌟 Ce que cela signifie
Septembre est une version pratique pour les équipes dont le travail s'étend de plus en plus aux personnes, aux scripts, aux agents et aux dépôts Git.
| Objectif | Ce qui est amélioré | Pourquoi c'est important |
|---|---|---|
| CLI et automatisation | Les modules, importations et cas de débogage peuvent être créés et gérés via la CLI. | L'automatisation et les agents peuvent participer plus tôt sans configuration manuelle de l'interface utilisateur. |
| Collaboration Git | Bitbucket Cloud et GitLab On-Prem se connectent aux flux de travail des projets. | Les équipes peuvent conserver les dépôts qu'elles utilisent déjà. |
| Qualité quotidienne | La gestion des URL, le filtrage des rapports, la complétion des variables et le chargement des projets sont améliorés. | Les étapes courantes de configuration et de révision demandent moins d'attention. |
| Docs, tests et spécifications | Les schémas sont publiés avec les sous-sites Docs, les résultats de performance rapportent P95 et P99, et le mode Spec bénéficie d'un démarrage plus clair. | Les schémas, la latence et le contexte « spec-first » sont visibles sans quitter le flux de travail. |
💬 Restons en contact
Vous avez des commentaires ou des questions ? 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) et LinkedIn pour les dernières mises à jour.
P.S. Pour chaque détail de cette version, consultez le Journal des modifications d'Apidog.
Cordialement,
L'équipe Apidog