アピドッグ 9月アップデート：モジュール式CLIワークフロー、Bitbucketクラウド、GitLabオンプレミス

Apidog 2.8.47～2.8.50にかけて、今月のアップデートにより、API自動化、リポジトリ統合、APIドキュメントの保守が容易になりました。これには、モジュール式CLIインポートとデバッグケースの作成から、Bitbucket Cloud、セルフホスト型GitLab接続、Docsサブサイトからのスキーマ公開までが含まれます。

このリリースは、自動化とGitコラボレーションのセットアップの手間を軽減することを目的としています。

9月のApidogアップデートは、チームがしばしば時間を浪費するポイントに焦点を当てています。具体的には、スクリプトやAIワークフローからの大規模なプロジェクト構造の管理、APIアセットを適切なモジュールへのインポート、ターミナルを離れずにテストアセットの作成、そしてチームの既存の作業方法を変えることなく既存のGitプロバイダーへの接続です。

概要：

Apidog CLI自動化: プロジェクトモジュールの管理、モジュールごとの複数形式APIデータのインポート、設定ファイルからのデバッグテストケースの作成。
Gitリポジトリ統合: Bitbucket CloudおよびGitLab On-Prem接続をプロジェクトのインポート/エクスポートワークフローに追加。
日常的な使いやすさ: より明確なURL処理、テストレポートのフィルタリング改善、テストデータ変数の補完、より高速なプロジェクトリスト。
Docsとパフォーマンスの可視性: Docsサブサイトがスキーマを公開し、パフォーマンステストがP95およびP99応答時間を報告。

🤖 API自動化とAIワークフローのためのApidog CLI

Apidog CLIはすでにCIテスト実行と自動化にとって有用なエントリーポイントとなっています。このリリースでは、ワークフローのより早い段階でこれを拡張します。チームは、テストを実行する前に、プロジェクト構造を管理し、データを適切なモジュールにインポートし、デバッグケースを作成できます。

CLIからプロジェクトモジュールを管理

Apidog CLIは、プロジェクトモジュールを照会、作成、更新、削除できるようになりました。

これは、モジュール構造を自動化ワークフローの一部として変更する必要がある場合に役立ちます。書き込み操作後、CLIは`moduleId`を含む構造化されたJSONを返すため、スクリプトやエージェントは、誰かにUIからコピーしてもらう代わりに、その識別子を後のインポート、テスト、または保守ステップに渡すことができます。

これにより、モジュール管理はAPIテストやCI自動化と同じ反復可能なループの一部となります。

選択したモジュールにAPIデータをインポート

CLIのインポートコマンドは、Apidogクライアントの解析機能を再利用するようにリファクタリングされました。これにより、まずUIでデータを作成してから後で移動するのではなく、サポートされているソースから指定されたプロジェクトモジュールにAPIデータを直接インポートできます。

大規模な移行の場合、インポート結果には追加、更新、無視、削除されたアイテムの数が含まれます。これにより、スクリプト、CIジョブ、AIエージェントが次のステップに進む前に何が起こったかを確認しやすくなります。

これは、複数の形式を同じプロジェクト構造に配置する必要があり、手動でのクリーンアップ手順を減らしたい場合に特に役立ちます。

設定からデバッグテストケースを作成

CLIユーザーは、設定ファイルからインターフェースデバッグテストケースを作成できるようになりました。設定では、ケース名、ターゲットAPI、リクエストパラメータ、リクエストボディ、認証、プリプロセッサ、ポストプロセッサ、およびレスポンス検証を定義できます。

作成後、デバッグケースは他のデバッグケースと同様にApidogで開く、編集する、実行することができます。これは、自動化やエージェントが最初のテストアセットを準備した後でも、開発者がそれを視覚的に検査し、洗練したい場合に役立ちます。

モジュール管理、構造化されたインポート、デバッグケースの作成が一体となることで、ローカルスクリプト、CI/CDパイプライン、AI支援ワークフローにおける手作業が削減されます。

既にApidog CLIがインストールされている場合は、新機能を使用する前にアップデートしてください。

npm install -g apidog-cli@latest

最新のコマンドリファレンスについては、Apidog CLIドキュメントを参照してください。

🔗 Gitリポジトリ統合

9月には、Gitベースのインポート/エクスポートが2つの一般的なリポジトリ環境に拡張されます。

Bitbucket Cloud

プロジェクトのインポートおよびエクスポートがBitbucket Cloudリポジトリをサポートするようになりました。Bitbucket Cloudを既に利用しているチームは、APIアセットを別のGitプラットフォームに移動することなく、既存のリポジトリをワークフローで使い続けることができます。

GitLabオンプレミス

組織はApidog SaaSでGitLabオンプレミスインスタンスを設定し、サポートされているGitリポジトリワークフローで使用できます。各組織は自身の接続を独立して管理するため、チームは既存のセルフホスト型GitLabセットアップを引き続き使用できます。

接続する前に、GitLabインスタンスのアドレスとネットワーク環境が接続要件を満たしていることを確認してください。

⚙️ 日常的な改善点

このリリースでは、日常のAPI作業における頻繁なフィードバックにも対応しています。

完全なURLが環境パスと競合しなくなりました

HTTP APIの作成または編集時、http://またはhttps://で始まる完全なURLを入力すると、環境パスがすぐに非表示になります。値を相対パスに戻すと、環境パスが復元されます。

これにより、完全なURLと環境パスが同時に表示されることによる混乱が解消され、動作を確認するためにまず保存する必要がなくなります。

より便利なテストレポートフィルタリング

テストレポートリストが、ランナーと実行元によるフィルタリングをサポートするようになりました。関連する表示フィールドも追加されたため、長いレポートリストを絞り込み、異なるソースからの最新レコードを比較することが容易になります。

テストデータ変数が補完に表示されるようになりました

既存のテストデータ変数が、コード補完と動的値補完の両方に表示されるようになりました。リクエストやテストを作成する際、変数リストに戻って名前をコピーする代わりに、直接変数を検索して選択できます。

より高速なプロジェクトリスト

ApidogはプロジェクトリストAPIの応答時間を最適化しました。ワークスペースへの入場時やプロジェクト検索時にプロジェクトリストの読み込みが高速化され、頻繁なナビゲーションや切り替え時の待ち時間が短縮されます。

✨ 今回のリリースで追加された項目

今月は、ドキュメント、パフォーマンステスト、スペックファーストのプロジェクト設定にわたる3つの変更で締めくくられます。

Docsサブサイトからスキーマを公開

Apidog Docsのサブサイトが、エンドポイントとともにスキーマを公開できるようになりました。これにより、公開されたサイトの閲覧者は、メインサイトに戻ることなくその場でスキーマを確認できます。Enterpriseサブサイトは、この機能を自身で有効にすることができます。

パフォーマンステストにおけるP95およびP99応答時間

パフォーマンステストの結果に、既存のメトリクスに加えてP95およびP99応答時間が報告されるようになりました。パーセンタイルは平均値では隠れてしまう遅延の末尾部分を示し、これは通常、ユーザーが実際に気づくAPIの部分です。

スペックモードのプロジェクト設定とOpenAPIインポート

スペックモードのプロジェクトが、OpenAPIのインポートおよび作成のエントリーポイントが直接表示される、より明確な空の状態に開かれるようになりました。これにより、スペックファーストのプロジェクトを開始する際に、開始方法を探す必要がありません。

🛠️ その他の修正と改善

このサイクルには、以下の修正と小さな変更も含まれています。

メインウィンドウとタブバーでの試用期間ステータスとアクションの表示方法を改善しました。
組織およびチームメンバーリストでの保留中の招待の表示方法を改善しました。
生成されたリクエストコード内のBasic認証変数が展開されず、直接Base64でエンコードされる問題を修正しました。
タブを編集する際に、allOfを使用して参照される結合データモデルフィールドが展開されない問題を修正しました。
プロジェクトをクローンまたはコピーした後、データモデルへのAPIプロジェクト間参照が正しくない問題を修正しました。
CLIによって作成されたデバッグケースがWebクライアントで認証タイプを「認証なし」と表示し、認証が適用されない問題を修正しました。
CLIインポート中にOpenAPIレスポンスの$ref定義がサイレントに破棄される問題を修正しました。
レポートリストのページネーションメタデータが誤ったpageSizeおよびpageIndex値を返す問題を修正しました。
JUnitとHTMLの両方のテストレポートを生成すると、JUnitレポートに最後のテストケース結果のみが含まれる問題を修正しました。
単一APIテストでURL環境を切り替える際に、環境ドロップダウンが開けない問題を修正しました。
エンタープライズポリシーを通じてホームページの招待報酬エントリーを無効にするサポートを追加しました。

詳細な項目別リストについては、Apidog変更ログをご覧ください。

🌟 これが意味すること

9月は、人、スクリプト、エージェント、Gitリポジトリにまたがる作業が増えているチームにとって、実用的なリリースです。

焦点	改善点	重要性
CLIと自動化	モジュール、インポート、デバッグケースをCLIを通じて作成および管理できるようになりました。	自動化とエージェントが、手動でのUI設定なしに早い段階で参加できます。
Git連携	Bitbucket CloudとGitLabオンプレミスがプロジェクトワークフローに接続します。	チームは既存の運用リポジリを維持できます。
日常的な品質	URL処理、レポートフィルタリング、変数補完、プロジェクトの読み込みが改善されます。	一般的な設定とレビューの手順にかかる手間が減ります。
Docs、テスト、仕様	Docsサブサイトでスキーマが公開され、パフォーマンス結果にP95とP99が報告され、スペックモードの開始がより明確になります。	スキーマ、レイテンシ、スペックファーストのコンテキストがワークフローを離れることなく可視化されます。

💬 ご連絡ください

フィードバックやご質問がありますか？他のAPIエンジニアやApidogチームとつながりましょう。

リアルタイムの議論とサポートのためにDiscordコミュニティに参加してください。
技術的な会話のためにSlackコミュニティに参加してください。
最新のアップデートについては、X (Twitter) およびLinkedInをフォローしてください。

追伸：このリリースの詳細については、Apidog変更ログをご確認ください。

敬具、

Apidogチーム