In den Apidog-Versionen 2.8.47–2.8.50 erleichtern die Updates dieses Monats die Pflege von API-Automatisierung, Repository-Integration und API-Dokumentation – von modularen CLI-Importen und der Erstellung von Debug-Fällen bis hin zu Bitbucket Cloud, selbstgehosteten GitLab-Verbindungen und Schemas, die von Docs-Unterseiten veröffentlicht werden.
Bei dieser Version geht es darum, die Automatisierung und Git-Kollaboration weniger zu einem Umweg beim Setup zu machen.
Die Apidog-Updates im September konzentrieren sich auf die Punkte, an denen Teams oft Zeit verlieren: die Verwaltung großer Projektstrukturen aus Skripten oder KI-Workflows, der Import von API-Assets in das richtige Modul, die Erstellung von Test-Assets, ohne das Terminal zu verlassen, und die Verbindung bestehender Git-Anbieter, ohne die bereits etablierte Arbeitsweise der Teams zu ändern.
Auf einen Blick:
- Apidog CLI-Automatisierung: Verwalten Sie Projektmodule, importieren Sie API-Daten in verschiedenen Formaten nach Modul und erstellen Sie Debug-Testfälle aus Konfigurationsdateien.
- Git-Repository-Integrationen: Fügen Sie Bitbucket Cloud- und GitLab On-Prem-Verbindungen zu den Import-/Export-Workflows von Projekten hinzu.
- Alltägliche Benutzerfreundlichkeit: Klarere URL-Behandlung, bessere Filterung von Testberichten, Vervollständigung von Testdatenvariablen und eine schnellere Projektliste.
- Docs- und Performance-Transparenz: Docs-Unterseiten veröffentlichen Schemas, und Performance-Tests berichten P95- und P99-Antwortzeiten.
🤖 Apidog CLI für API-Automatisierung und KI-Workflows
Die Apidog CLI hat sich bereits als nützlicher Einstiegspunkt für CI-Testläufe und Automatisierung etabliert. Diese Version erweitert sie früher im Workflow: Teams können die Projektstruktur verwalten, Daten in das richtige Modul bringen und Debug-Fälle erstellen, bevor sie Tests ausführen.
Projektmodule über die CLI verwalten
Die Apidog CLI kann jetzt Projektmodule abfragen, erstellen, aktualisieren und löschen.
Dies ist nützlich, wenn die Modulstruktur im Rahmen eines automatisierten Workflows geändert werden muss. Nach einem Schreibvorgang gibt die CLI strukturiertes JSON zurück, das die moduleId enthält, sodass Skripte und Agenten die Kennung an spätere Import-, Test- oder Wartungsschritte übergeben können, anstatt jemanden aufzufordern, sie aus der Benutzeroberfläche zu kopieren.
Das macht die Modulverwaltung zu einem Teil des wiederholbaren Kreislaufs wie API-Tests und CI-Automatisierung.
API-Daten in ein ausgewähltes Modul importieren
Der CLI-Importbefehl wurde refaktorisiert, um die Parsing-Funktionen des Apidog-Clients wiederzuverwenden. Sie können API-Daten aus unterstützten Quellen in ein bestimmtes Projektmodul importieren, anstatt die Daten zuerst in der Benutzeroberfläche zu erstellen und später zu verschieben.
Für größere Migrationen umfassen die Importergebnisse Zählungen der hinzugefügten, aktualisierten, ignorierten und entfernten Elemente. Dies erleichtert es Skripten, CI-Jobs und KI-Agenten, zu überprüfen, was passiert ist, bevor sie zum nächsten Schritt übergehen.
Dies ist besonders nützlich, wenn mehrere Formate mit weniger manuellen Bereinigungsschritten in derselben Projektstruktur landen müssen.
Debug-Testfälle aus Konfiguration erstellen
CLI-Benutzer können jetzt Debug-Testfälle für Schnittstellen aus Konfigurationsdateien erstellen. Eine Konfiguration kann den Fallnamen, die Ziel-API, die Anforderungsparameter, den Anforderungsbody, die Authentifizierung, Pre-Prozessoren, Post-Prozessoren und die Antwortvalidierung definieren.
Nach der Erstellung kann der Debug-Fall in Apidog wie jeder andere Debug-Fall geöffnet, bearbeitet und ausgeführt werden. Dies ist nützlich, wenn die Automatisierung oder ein Agent das initiale Test-Asset vorbereitet, ein Entwickler es aber dennoch visuell überprüfen und verfeinern möchte.
Zusammen reduzieren Modulverwaltung, strukturierte Importe und die Erstellung von Debug-Fällen den manuellen Aufwand bei lokalen Skripten, CI/CD-Pipelines und KI-gestützten Workflows.
Wenn Sie die Apidog CLI bereits installiert haben, aktualisieren Sie sie, bevor Sie die neuen Funktionen nutzen:
npm install -g apidog-cli@latestDie Apidog CLI-Dokumentation enthält die neueste Befehlsreferenz.
🔗 Git-Repository-Integrationen
Der September erweitert auch den Git-basierten Import/Export auf zwei gängige Repository-Umgebungen.
Bitbucket Cloud
Projektimport und -export unterstützen jetzt Bitbucket Cloud-Repositories. Teams, die bereits Bitbucket Cloud verwenden, können ihre bestehenden Repositories im Workflow behalten, anstatt API-Assets auf eine andere Git-Plattform zu verschieben.
GitLab On-Prem
Organisationen können eine GitLab On-Prem-Instanz in Apidog SaaS konfigurieren und diese in unterstützten Git-Repository-Workflows verwenden. Jede Organisation verwaltet ihre Verbindung unabhängig, sodass Teams ihre bestehende selbstgehostete GitLab-Einrichtung weiterhin nutzen können.
Stellen Sie vor der Verbindung sicher, dass die GitLab-Instanzadresse und die Netzwerkumgebung die Verbindungsanforderungen erfüllen.
⚙️ Alltägliche Verbesserungen
Die Version berücksichtigt auch häufiges Feedback aus der täglichen API-Arbeit.
Komplette URLs kollidieren nicht mehr mit dem Umgebungspfad
Beim Erstellen oder Bearbeiten einer HTTP-API blendet die Eingabe einer vollständigen URL, die mit http:// oder https:// beginnt, den Umgebungspfad sofort aus. Das Zurückändern des Wertes zu einem relativen Pfad stellt den Umgebungspfad wieder her.
Dies beseitigt die Verwirrung, gleichzeitig eine vollständige URL und einen Umgebungspfad zu sehen, und macht das Speichern zum Anzeigen des Verhaltens überflüssig.
Nützlichere Filterung von Testberichten
Listen von Testberichten unterstützen jetzt die Filterung nach Runner und Ausführungsquelle. Entsprechende Anzeigefelder wurden ebenfalls hinzugefügt, wodurch es einfacher ist, eine lange Berichtsliste einzugrenzen und aktuelle Aufzeichnungen aus verschiedenen Quellen zu vergleichen.
Testdatenvariablen erscheinen in der Vervollständigung
Bestehende Testdatenvariablen erscheinen jetzt sowohl in der Code-Vervollständigung als auch in der dynamischen Wert-Vervollständigung. Beim Schreiben von Anfragen oder Tests können Sie die Variable direkt suchen und auswählen, anstatt zur Variablenliste zurückzukehren, um deren Namen zu kopieren.
Schnellere Projektlisten
Apidog hat die Antwortzeit der Projektlisten-API optimiert. Projektlisten laden schneller beim Betreten eines Arbeitsbereichs oder beim Auffinden eines Projekts, wodurch die Wartezeit bei häufiger Navigation und Wechsel reduziert wird.
✨ Ebenfalls in dieser Version
Drei Änderungen runden den Monat ab und umfassen Dokumentation, Performance-Tests und die projektübergreifende Einrichtung von Spezifikationen.
Schemas von Docs-Unterseiten veröffentlichen
Unterseiten in Apidog Docs können jetzt Schemas neben Endpunkten veröffentlichen, sodass Leser einer veröffentlichten Seite diese direkt an Ort und Stelle sehen können, anstatt zur Hauptseite wechseln zu müssen. Enterprise-Unterseiten können diese Funktion selbst aktivieren.
P95- und P99-Antwortzeiten in Performance-Tests
Performance-Testergebnisse melden jetzt P95- und P99-Antwortzeiten neben bestehenden Metriken. Perzentile beschreiben die langsame Schwanzkurve, die Durchschnittswerte verbergen, was meist der Teil einer API ist, den Benutzer tatsächlich bemerken.
Spec-Modus Projekteinrichtung und OpenAPI-Import
Projekte im Spec-Modus öffnen sich jetzt in einem klareren leeren Zustand, wobei die OpenAPI-Import- und Erstellungseinstiegspunkte direkt angezeigt werden, sodass ein Spec-First-Projekt beginnen kann, ohne nach dem Einstieg suchen zu müssen.
🛠️ Zusätzliche Fehlerbehebungen und Verbesserungen
Dieser Zyklus umfasst auch die folgenden Fehlerbehebungen und kleinere Änderungen:
- Verbesserte Anzeige des Teststatus und der Aktionen im Hauptfenster und in der Registerkartenleiste.
- Verbesserte Anzeige ausstehender Einladungen in den Listen der Organisationen und Teammitglieder.
- Es wurde ein Problem behoben, bei dem Basic Auth-Variablen im generierten Anforderungscode nicht erweitert und direkt als Base64 kodiert wurden.
- Es wurde ein Problem behoben, bei dem beim Bearbeiten einer Registerkarte referenzierte kombinierte Datenmodellfelder mit
allOfnicht erweitert wurden. - Es wurde ein Problem behoben, bei dem API-Projektübergreifende Referenzen auf Datenmodelle nach dem Klonen oder Kopieren eines Projekts falsch waren.
- Es wurde ein Problem behoben, bei dem über die CLI erstellte Debug-Fälle den Authentifizierungstyp als „Keine Authentifizierung“ im Web-Client anzeigten und keine Authentifizierung anwendeten.
- Es wurde ein Problem behoben, bei dem OpenAPI-Antwort-
$ref-Definitionen während des CLI-Imports stillschweigend verworfen wurden. - Es wurde ein Problem behoben, bei dem die Paginierungsmetadaten der Berichtsliste falsche
pageSize- undpageIndex-Werte zurückgaben. - Es wurde ein Problem behoben, bei dem die Generierung sowohl von JUnit- als auch von HTML-Testberichten dazu führte, dass der JUnit-Bericht nur das Ergebnis des letzten Testfalls enthielt.
- Es wurde ein Problem behoben, bei dem das Umgebungs-Dropdown nicht geöffnet werden konnte, wenn URL-Umgebungen in einzelnen API-Tests gewechselt wurden.
- Unterstützung für die Deaktivierung des Belohnungseintrags für Homepage-Einladungen durch Unternehmensrichtlinien hinzugefügt.
Eine vollständige Liste der einzelnen Elemente finden Sie im Apidog Changelog.
🌟 Was das bedeutet
Der September ist eine praktische Veröffentlichung für Teams, deren Arbeit zunehmend Menschen, Skripte, Agenten und Git-Repositories umfasst.
| Fokus | Was verbessert wird | Warum es wichtig ist |
|---|---|---|
| CLI und Automatisierung | Module, Importe und Debug-Fälle können über die CLI erstellt und verwaltet werden. | Automatisierung und Agenten können früher ohne manuelle UI-Einrichtung mitwirken. |
| Git-Kollaboration | Bitbucket Cloud und GitLab On-Prem verbinden sich mit Projekt-Workflows. | Teams können die Repositories behalten, die sie bereits verwenden. |
| Alltägliche Qualität | URL-Handhabung, Berichtsfilterung, Variablenvervollständigung und Projektladen werden verbessert. | Häufige Einrichtungs- und Überprüfungsschritte erfordern weniger Aufmerksamkeit. |
| Docs, Tests und Spezifikationen | Schemas werden mit Docs-Unterseiten veröffentlicht, Performance-Ergebnisse melden P95 und P99, und der Spec-Modus erhält einen klareren Start. | Schemas, Latenz und der Spec-First-Kontext sind sichtbar, ohne den Workflow zu verlassen. |
💬 Bleiben Sie in Kontakt
Haben Sie Feedback oder Fragen? Verbinden Sie sich mit anderen API-Ingenieuren und dem Apidog-Team:
- Treten Sie unserer Discord-Community für Echtzeit-Diskussionen und Support bei.
- Nehmen Sie an unserer Slack-Community für technische Gespräche teil.
- Folgen Sie uns auf X (Twitter) und LinkedIn für die neuesten Updates.
P.S. Alle Details zu dieser Version finden Sie im Apidog Changelog.
Mit freundlichen Grüßen,
Das Apidog-Team