6月のアップデートでは、AI対応のCLI操作、Postman/OpenAPIインポートの改善、OAuth 2.0トークンの自動リフレッシュ、テスト・設定まわりの改善が追加されました。日常的なAPI開発、デバッグ、自動テストをより安定して回すための変更です。
この記事では、今回の変更を「どのワークフローで使うか」に絞って整理します。
新機能と改善
Apidog CLIでAIを活用したAPIワークフローを実行する
Apidog CLIは、AIエージェントがApidogプロジェクト内のリソースを構造化された形で扱うための実行レイヤーとして強化されています。
手動で個別の操作を行う代わりに、AIエージェントが以下のようなAPI作業を実行しやすくなります。
- Apidogプロジェクトリソースの読み取り
- 変更内容の書き込み
- 構造化された操作の検証
- データのエクスポート
- テストケースの実行
- シナリオケースからエンドポイント、テストケース、他のシナリオを参照
- ネイティブ形式 / OpenAPI形式でのエクスポート時のスコープ制御
実装イメージとしては、AIエージェントに自然言語でAPIタスクを指示し、Apidog CLIを通じて実際のプロジェクトリソースに対して操作させる形です。
ユーザー指示
↓
AIエージェント
↓
Apidog Skills + Apidog CLI
↓
Apidogプロジェクトリソース
↓
検証・テスト・エクスポート
Apidog Skillsと組み合わせることで、AIエージェントに対して以下を提供できます。
- 何を操作してよいか
- どのリソースを参照すべきか
- 変更を書き戻す前にどう検証するか
- 推測ではなくプロジェクトコンテキストに基づいてAPIタスクを完了する方法
CLIは、自然言語のAI指示と構造化されたApidogプロジェクト操作をつなぐ実行レイヤーです。
インポート / エクスポートのクリーンアップを減らす
Postman、OpenAPI、Swaggerから移行・同期するチーム向けに、インポートとエクスポートの挙動が改善されました。
Postman APIインポート時の変数名クリーンアップ
Postman APIを通じてデータをインポートする際、Apidogは変数名からスペースを削除できるようになりました。
これにより、インポート後に次のような手作業を減らせます。
Before: {{ access token }}
After: {{ accesstoken }}
変数名にスペースが含まれていると、後続のスクリプト、リクエスト、環境変数参照で扱いにくくなることがあります。今回の改善により、移行直後の修正コストを下げられます。
Postmanワークスペース名の識別性を改善
Postman API経由でワークスペースをインポートする際、Apidogはワークスペース作成者に基づいて紛らわしい「My Workspace」名を変更できるようになりました。
複数ワークスペースをまとめて移行する場合、インポート後にどのワークスペースが誰のものかを判別しやすくなります。
OpenAPI / Swaggerの複雑なパラメータ対応
OpenAPIおよびSwaggerのインポート / エクスポートでは、オブジェクト型パラメータと参照型パラメータをサポートするようになりました。
これにより、次のような構造を持つAPI仕様をより保持しやすくなります。
parameters:
- name: filter
in: query
schema:
type: object
properties:
status:
type: string
ownerId:
type: string
parameters:
- $ref: '#/components/parameters/PaginationParam'
| 以前 | 現在 |
|---|---|
| インポートされた変数に手動クリーンアップが必要な場合があった | Postman APIインポートで変数名からスペースを削除可能 |
| 複数のインポート済みワークスペース名が紛らわしい場合があった | 曖昧なワークスペース名を識別しやすい名前に変更可能 |
| 複雑なOpenAPIパラメータはインポート / エクスポート後に調整が必要な場合があった | OpenAPI / Swaggerのインポート / エクスポートがオブジェクト型・参照型パラメータをサポート |
OAuth 2.0トークンを自動リフレッシュする
OAuth 2.0認証で、トークンの自動リフレッシュがサポートされました。
アクセストークンの有効期限が近い場合、またはすでに期限切れの場合でも、Apidogが自動的にトークンをリフレッシュします。これにより、以下のような作業を減らせます。
- 手動で再認証する
- 新しいアクセストークンをコピーする
- リクエストヘッダーを更新する
- テスト実行をやり直す
OAuthで保護されたAPIを継続的にデバッグする場合、トークン期限切れによる中断が減ります。
リクエスト実行
↓
アクセストークン期限を確認
↓
必要に応じて自動リフレッシュ
↓
リクエスト継続
APIデバッグ、テスト、繰り返しのリクエスト検証中に発生する認証中断を減らせます。
ユーザーフィードバックによる改善
MCPクライアントの互換性向上
ApidogはMCPクライアントの互換性を改善し、非標準スキーマをより確実に解析できるようになりました。
MCPサーバーやツールのスキーマ出力が期待される形式に厳密に従っていない場合でも、Apidogがより多くの現実的なレスポンスを処理できます。
これにより、MCPツール統合やデバッグ時に、スキーマ差分による失敗を減らせます。
テストスイートで静的ステップを名前検索する
テストスイートに静的ステップを追加する際、名前で検索できるようになりました。
大規模なプロジェクトでは、エンドポイント、テストケース、シナリオが増えるほど、目的のステップを探す時間が増えます。名前検索により、以下の作業が速くなります。
- テストスイートを開く
- 静的ステップを追加
- 名前で対象ステップを検索
- 必要なステップを追加
多数のAPIを扱うチームでは、テストスイート構築時の操作時間を削減できます。
スケジュールタスクに「8時間ごと」を設定する
スケジュールタスクに「8時間ごと」のオプションが追加されました。
以下のような用途で使いやすい間隔です。
- 定期的な自動テスト
- 監視に近いAPIチェック
- ステージング環境の定期検証
- 日中に複数回実行したい回帰テスト
例:
00:00 実行
08:00 実行
16:00 実行
1日3回のAPI検証を自動化したい場合に便利です。
Apidog Webアプリで自動生成ヘッダーを設定する
Apidog Webアプリでは、自動生成されるヘッダーの設定をサポートするようになりました。
これにより、ブラウザベースのワークフローでも、生成されるリクエストヘッダーをチームやプロジェクトのルールに合わせて調整しやすくなります。
たとえば、リクエストの挙動を確認する際に、Webアプリ上でヘッダー設定を管理しやすくなります。
バグ修正とその他の改善
今月は、以下の修正と小さな改善もリリースされています。
- 大規模なテストシナリオを子ブランチに選択する際のパフォーマンスを改善し、タイムアウトエラーの可能性を削減
- スプリントブランチと一般ブランチのリストで、ブランチIDの表示とコピーをサポート
- macOSがイントラネットリクエストを送信できない場合に、よりユーザーフレンドリーなプロンプトを表示
- 新しいモジュールにApidogデータを再インポートする際、サービスベースURLがインポートされず、エンドポイントが指定されたサービスにバインドされない問題を修正
- リクエストヘッダーに追加されるように設定されたOAuth 1.0認証が、実際にはリクエストヘッダーに追加されない問題を修正
- Basic認証で中国語の変数が使用されている場合に、生成されたエンドポイントリクエストコードが正しく機能しない問題を修正
- エンドポイントがHTTPを使用しているにもかかわらず、生成されたリクエストコードが誤ってHTTPSを使用する問題を修正
- シナリオステップが生形式のレスポンスボディを参照している場合に、CLIシナリオの実行が「Unexpected token」を報告する可能性がある問題を修正
- 自動テストシナリオが異常終了した後も、テストレポートの詳細が実行中と表示される問題を修正
- ルートフォルダでシナリオケースを実行した後、テストレポートリストに対応するレポートが表示されない問題を修正
- Apidog Webアプリを更新すると、プロジェクトが自動的にメインブランチに戻る問題を修正
- ブランチインポート時やMarkdownでエンドポイントを挿入する際に、タグフィルターオプションに内容がない問題を修正
- 複数のモジュールとサービスを含むApidogファイルをインポートする際、非デフォルトのサービスが繰り返し追加される問題を修正
- Apidogデータをインポートする際、Markdownドキュメントのタグが正しくインポートされない問題を修正
- 一部のケースで、エンドポイントをメインブランチにマージした後も競合が表示される問題を修正
- 一部のケースで、SSEエンドポイントをデバッグする際にフロントエンドエラーが発生する可能性がある問題を修正
- オンプレミスプロジェクトの統計がデフォルトモジュールのデータのみをカウントする問題を修正
- チーム詳細ページからマルチモジュールApidogファイルをインポートする際、エンドポイントが誤ってデフォルトモジュールにインポートされる問題を修正
- 一部のケースで、変更を送信した後、変更が消えてしまう問題を修正
- パスワード変更時のメール確認フローで誤ったエラーメッセージが表示される問題を修正
実務での使いどころ
今回のアップデートは、以下のワークフローで効果があります。
| 分野 | 改善点 | 実務でのメリット |
|---|---|---|
| AIを活用したCLIワークフロー | CLIがAIエージェントによるApidogプロジェクト操作、テストケース実行、既存アセット参照、エクスポート制御を支援 | AIエージェントが非構造化情報から推測せず、実際のプロジェクトコンテキストでAPIタスクを進めやすくなる |
| インポート / エクスポート | Postman APIインポートで変数名をクリーンアップし、ワークスペース名を明確化。OpenAPI / Swaggerでオブジェクト型・参照型パラメータをサポート | 移行後の手動修正が減り、API仕様の交換がより完全になる |
| 認証 | OAuth 2.0トークンを自動リフレッシュ | APIデバッグやテスト中の再認証作業を削減 |
| MCP互換性 | MCPクライアントがより多くの非標準スキーマを解析 | MCPツールやサーバーとの統合成功率を向上 |
| テストワークフロー | 静的ステップを名前検索可能。スケジュールタスクに8時間間隔を追加 | テストスイート作成を高速化し、定期テストを柔軟に実行 |
| Webアプリ設定 | 自動生成ヘッダーをApidog Webアプリで設定可能 | ブラウザベースのリクエスト挙動をより細かく制御 |
まとめると、今回のアップデートにより、AIエージェント、API仕様、インポート済みデータ、OAuth認証、自動テストをまたぐワークフローが扱いやすくなります。
特に以下に当てはまるチームは、今回の変更を確認しておくとよいでしょう。
- PostmanからApidogへデータを移行している
- OpenAPI / Swaggerを中心にAPI仕様を管理している
- OAuth 2.0で保護されたAPIを頻繁にデバッグしている
- AIエージェントをAPI開発ワークフローに組み込みたい
- 定期的なAPIテストや監視スタイルのチェックを自動化している
コミュニティに参加する
他のAPIエンジニアやApidogチームと交流できます。
- リアルタイムのディスカッションとサポートには、Discordコミュニティをご利用ください。
- 技術的な会話には、Slackコミュニティをご利用ください。
- 最新情報は、X（旧Twitter）で確認できます。
すべてのアップデートの詳細は、Apidogチェンジログをご確認ください。
敬具
Apidogチーム
Top comments (0)