Apiaryは閉鎖されます。OracleはApiaryサポート終了の発表を行っており、APIツール業界全体の報道によると、ホスト型サービスの最終的なシャットダウンは2026年9月頃とされています。サイトは今日でもアクセス可能ですが、その方向性は数年前から明らかでした。Oracleは2017年1月にApiaryを買収し、2018年には有料プランを非推奨とし、関連するオープンソースツール（Dredd、Gavel）はアーカイブ状態へと移行しました。apiary.ioでAPIドキュメントを管理している場合、もはや代替案を検討している段階ではありません。あなたは移行を進めており、その期限はあなたの都合で変更できるものではありません。
直接的な答えを申し上げます。ApidogはApiaryの最良の代替ツールです。なぜなら、Apiaryが行っていたことすべて（デザインファーストの仕様編集、ホスト型インタラクティブドキュメント、モックサーバー）を置き換え、Apiaryが未完成だった部分、すなわち自動APIテスト、現在アーカイブされたDreddに代わる仕様駆動型検証、そしてCI連携を追加するからです。最大4ユーザーまで無料で利用でき、有料プランは月額9ドル/ユーザーからです。正直なところ、唯一の注意点は、ApidogがAPI Blueprintファイルを直接インポートしないため、Blueprintベースのプロジェクトは一度OpenAPIへの変換が必要となることです。この記事では、Apiaryに何が起こっているのか、その変換ステップを含む正確な移行パス、そしてApidogが合わない場合の代替案について説明します。
button
Apiaryに実際に何が起きているのか
2011年に設立されたApiaryは、製品としてデザインファーストのAPIワークフローを効果的に発明しました。OpenAPIが主流になる前の時代から、MarkdownベースのAPI記述形式であるAPI Blueprintを世に送り出し、Stripeが有名にし、他の誰もが模倣した3カラムのドキュメントレイアウトを提供しました。ホスト型モックサーバー、GitHub同期、そして評判の良いオープンソースの契約テストツールであるDreddとGavelをバンドルしていました。
その後、2017年1月にOracleが買収し、製品は長い沈黙に入りました。2018年には有料ティアが非推奨となり、Apiaryは無料のレガシーサービスとして残され、Oracleはエンタープライズ顧客をそのAPI Platform Cloudに誘導しました。新機能の開発は停止し、DreddとGavelはアーカイブされました。そして今、正式な終わりが訪れました。Oracleのサポート終了発表があり、ホスト型サービスは2026年9月頃に停止すると予想されています。移行ガイドを公開しているベンダーの一つであるBump.shは、その惜別の投稿で簡潔に述べました。「シャットダウン前にAPI記述をエクスポートしてください。なぜなら、その後にはエクスポートするものさえ残らないからです。」
これには2つの実際的な結果が伴います。第一に、Apiary内にのみ存在するすべて（API記述、ドキュメントの散文、チーム設定）は、エクスポートボタンがまだ機能しているうちに今すぐ移行する必要があります。第二に、API Blueprintには保守されている後継ツールがないため、移行はフォーマットの移行でもあります。どのプラットフォームに移行するとしても、適切な移行先フォーマットはOpenAPIです。
何が置き換えられるのか
Apiaryが実際にあなたのチームのために何を行っていたかを正確に把握することが重要です。なぜなら、代替ツールはそれらの各要素をカバーする必要があるからです。
- デザインファーストの仕様エディター。ブラウザでAPI Blueprint（または、後のプロジェクトではOpenAPI 3.0）を記述し、ドキュメントはリアルタイムで更新されました。
- ホスト型インタラクティブドキュメント。apiary.ioのURLで、例となるリクエストを含む3カラムのリファレンス。
- モックサーバー。すべてのApiaryプロジェクトは、仕様からの例を提供するホスト型モックエンドポイントを取得し、バックエンドが存在する前に利用者が統合できました。
- GitHub同期。仕様ファイルはリポジトリに保存され、双方向で同期されました。
- Dreddを介した契約テスト。実際の実装に対して仕様を再生し、乖離を報告するオープンソースのランナー。現在はアーカイブされています。私たちはDreddなしでAPIをその仕様に対して検証する方法でその置き換え問題を扱いました。
そのバンドル（デザイン、ドキュメント、モック、検証）は、まさに現代のAPI開発プラットフォームの形そのものです。だからこそ、最良の移行先はドキュメントレンダラーではなく、同じ形を持ち、活発な開発が行われているプラットフォームなのです。
その答え：Apidog
Apidogは50万人以上の開発者に利用されているAPI開発プラットフォームです。Apiaryが2011年に概説し、その後構築を停止したライフサイクル全体（設計、ドキュメント、モック、デバッグ、自動テスト）を、すべて単一の仕様に基づいてカバーしています。
特にApiaryから移行する人にとって：
- デザインファーストがデフォルトのワークフローです。ApidogはOpenAPI 3.x用のビジュアル仕様エディターとコードエディターの両方を提供します。エンドポイント、スキーマ、および例を一度定義すれば、ドキュメント、モック、テストはその定義から生成されたビューとなります。これはApiaryが先駆的に取り入れた哲学と同じであり、メンテナンスされている製品がそれを支えています。
- ドキュメントはホスト型で、インタラクティブであり、あなたのものです。公開されたドキュメントは、動作する「試す」コンソールを備えた最新のリファレンスレイアウトで、カスタムドメイン上でバージョン管理とともに提供されます。シャットダウンで失われるapiary.ioのURLはありません。
- モックサーバーは、あなたが去るものよりも賢いです。Apiaryのモックはあなたが書いた例を再生しました。Apidogのスマートモックは、仕様が存在した瞬間にスキーマからリアルなレスポンスを自動的に生成し、例は不要です。決定論が重要な場合にはカスタムモックルールを追加することもできます。
- 契約検証がDreddに置き換わります。Apidogの自動テストシナリオは、実装に対して実際のリクエストを実行し、仕様のスキーマに対してレスポンスを検証します。これはDreddが行っていた作業に加え、アサーション、データ駆動型ケース、およびApidog CLIを介したCI実行が含まれます。ドキュメントはMCPサーバーと並行して公開され、AIエージェントが仕様を直接読み取ることができます。Apidog MCP Serverとはで詳細を確認してください。
Apiaryからの段階的な移行
この移行には、通常のツール切り替えに比べて1つの追加ステップがあり、それを最初に伝えるのが良いでしょう。Apidogのインポートドキュメントによると、ApidogはOpenAPI（Swagger 2.0、OpenAPI 3.0および3.1）、Postmanコレクション、HAR、RAML、JMeter、apiDoc、I/O Docs、WADL、およびGoogle Discoveryをインポートします。API Blueprintはそのリストには含まれていないため、Blueprintプロジェクトは最初にOpenAPIに変換する必要があります。実際には、これは一度限りのコマンドであり、他のすべての主要な移行先でも必要とされるステップです。なぜなら、Blueprintのツールはもはや誰もメンテナンスしていないからです。
1. 今すぐApiaryからすべてをエクスポートする
各プロジェクトについて、ApiaryエディターからAPI記述をダウンロードしてください。プロジェクトがGitHubと同期している場合、あなたの真の情報源はすでにリポジトリにあります。それが最新であることを確認してください。後期のApiaryプロジェクトでOpenAPI 3.0で作成されたものは、すでに正しいフォーマットであり、ステップ2をスキップできます。他の何かに着手する前に、これを最初から完全に実行してください。エクスポートは期限があるステップです。
2. API BlueprintをOpenAPIに変換する
メンテナンスされているコンバーターのいずれかを使用してください。
api-spec-converter(LucyBot): API BlueprintからOpenAPIへ直接変換します。apib2swagger: BlueprintからSwagger/OpenAPIに特化したコンバーターです。openapi-format: 出力を正規化し、OpenAPI 3.1にアップグレードしたい場合に使用します。
次に、結果をリント（vacuumのようなバリデーター、またはツールチェーン内の任意のOpenAPIリンターを使用）し、既知の2つの弱点を手動で確認してください。API Blueprintが正式にモデル化しなかったため、コンバーターが完全に復元できない認証スキームと、エンドポイント記述ではなくBlueprintのMarkdownセクションに存在していた散文です。1つのAPIにつき1週間ではなく、1時間の予算で考えてください。フォーマットはMarkdownであり、魔法ではありません。
3. Apidogにインポートする
プロジェクト設定で「手動インポート」を選択し、OpenAPIファイル（またはURLからインポート）を選択します。エンドポイント、スキーマ、および例は構造化され、グループ化されてインポートされます。リファレンスドキュメントはすぐに作成され、スマートモックサーバーは、追加設定なしですべてのインポートされたエンドポイントに対してライブで利用可能になり、Apiaryが提供していた「利用者向けモックURL」の機能が回復します。
4. Apiaryではできなかった部分を再構築する
公開されたドキュメントにカスタムドメインを設定することで、次に（どのプラットフォームの）シャットダウンが起こっても、ドキュメントのURLが失われることはありません。DreddのチェックをApidogのテストシナリオとして再作成します。CLIを介して、実際の要求、仕様に対するスキーマ検証をローカルまたはCIで実行します。チームがApiaryのモックURLに依存していた利用者がいる場合、ドキュメントの移動を知らせる同じメールで新しいモックベースURLを送信してください。
単一のAPIプロジェクトであれば、変換を含めて午後のうちに移行が完了します。1ダースのBlueprint APIのポートフォリオであっても、そのほとんどは認証スキームの手動チェックで済むため、短期間で移行できます。
Apiary vs Apidog 比較一覧
| Apiary (現在) | Apidog | |
|---|---|---|
| 将来 | 閉鎖予定; サポート終了、サービス終了は2026年9月頃を予定 | 活発に開発中 |
| 仕様フォーマット | API Blueprint、その後OpenAPI 3.0 | OpenAPI 3.x (Swagger 2.0インポート)、ビジュアル + コードエディター |
| ホスト型ドキュメント | あり、apiary.io URL | あり、カスタムドメイン、バージョン管理、試用コンソール |
| モックサーバー | 記述された例を再生 | スキーマを認識するスマートモック、カスタムルールも可能 |
| 契約テスト | Dredd (アーカイブ済み) | 組み込みのテストシナリオ、スキーマ検証、CLIによるCI |
| 自動テストスイート | なし | あり、ビジュアルシナリオ、データ駆動型、無制限実行 |
| GitHub同期 | あり | URLまたはファイルからの仕様インポート/同期; ブランチベースのバージョン管理 |
| 価格 | 無料 (有料プランは2018年に非推奨) | 4ユーザーまで無料、その後は月額9ドル/ユーザー |
| エクスポートパス | API Blueprint / OpenAPI ダウンロード | OpenAPI、Markdown、HTMLエクスポート |
無料ツールを置き換えるコスト
Apiaryの価格は、その残された最良の特徴でした。したがって、移行するチームにとって公平な比較は、移行先の年間費用です。定価を使用すると、Apidogは4ユーザーまで無料で、その後は月額9ドル/ユーザー。SwaggerHub Teamは月額34.44ドル/ユーザー。ReadMe Proは月額250ドル（年間請求）です。
| チームサイズ | Apidog 年間費用 | SwaggerHub Team 年間費用 | ReadMe Pro 年間費用 |
|---|---|---|---|
| 3人 | $0 (無料プラン) | $1,240 | $3,000 |
| 5人 | $540 | $2,066 | $3,000 |
| 10人 | $1,080 | $4,133 | $3,000 |
| 25人 | $2,700 | $10,332 | $3,000 |
正直なところ、もし単一の仕様を無料でレンダリングする場所だけが必要なら、いくつかのドキュメント専用ツールにも無料ティアがあります。上記の表は、Apiaryをそもそも役立つものにしたモックサーバー、テスト、コラボレーション機能が必要になった場合にのみ意味を持ちます。Apidogの無料プランは、最大4ユーザーまでこれらすべてをカバーしており、多くのApiaryユーザーにとっては、移行コストは変換に要する午後の時間だけを意味します。
Apidogが合わない場合
「Apiaryを使い続ける」という選択肢がないため、正直なセクションです：
- ドキュメントのレンダリングのみが必要で、他は不要な場合。仕様が他の場所で作成・テストされており、変更ログツールを備えた美しいホスト型ドキュメントだけが必要な場合、Bump.sh（Apiaryユーザー向けの移行ガイドは本当に優れています）のようなドキュメントファーストの製品が合理的な選択肢となります。その場合でも、BlueprintをOpenAPIに変換する必要があります。
- SmartBearスタックに標準化している場合。SwaggerHubは、Apiaryのホスト型仕様レジストリのアイデアに最も近い哲学的な後継です。シートごとのコストと従量課金制のテスト実行に注意してください。最高のSwaggerHub代替品でその詳細を解説しています。
- 大規模なプラットフォームチームのデザインガバナンスが重視される場合。Stoplightは深いスタイルガイドとガバナンスツールを構築しています。コミットする前に、最高のStoplight代替品で比較を確認してください。
- API Blueprintに感情的に執着している場合。共感はしますが、お勧めしません。このフォーマットのツールはメンテナンスされておらず、作成元企業はサービスを終了し、OpenAPIが勝利しました。一度変換してしまえば、二度と考える必要はありません。以前のAPI Blueprintのガイドは歴史的な読み物として残しておくことができます。
よくある質問
Apiaryはいつ完全にシャットダウンしますか？
OracleはフォーラムでApiaryサポートの終了を発表しており、APIツールベンダーからの現在の報告によると、ホスト型サービスのシャットダウンは2026年9月頃とされています。より安全な考え方は単純です。今すぐエクスポートしてください。なぜなら、製品のあらゆる部分がすでにメンテナンスされていないからです。
ApidogはAPI Blueprintファイルを直接インポートできますか？
できません。ApidogはOpenAPI/Swagger、Postman、HAR、RAML、JMeter、apiDoc、I/O Docs、WADL、およびGoogle Discoveryフォーマットをインポートします。最初にapi-spec-converterやapib2swaggerのようなツールでAPI BlueprintをOpenAPIに変換し、その結果をインポートしてください。これは一度限りのステップであり、その後は認証スキームを手動で確認してください。
Apiaryのモックサーバーの代替は何ですか？
Apidogに組み込まれているスマートモックサーバーです。Apiaryが書かれた例を再生していたのに対し、Apidogはスキーマからリアルなレスポンスを自動的に生成し、特定のケースのためにカスタムモックルールを定義できます。インポートされたすべてのエンドポイントは、設定なしでモックエンドポイントを取得します。
契約テストのためのDreddの代替は何ですか？
Apidogの自動テストシナリオがそれです。Apidogは、実装に実際のリクエストを送信し、仕様のスキーマに対してレスポンスを検証します。これにはアサーションとApidog CLIを介したCI実行が含まれます。これにより、Dreddの役割に加え、Dreddにはなかったテストスイート機能もカバーされます。
Apidogは小規模チームにとって本当に無料ですか？
はい、そうです。無料プランは、仕様エディター、公開されたインタラクティブドキュメント、スマートモックサーバー、APIテストを含め、最大4ユーザーまでカバーします。4ユーザーを超えると、月額9ドル/ユーザーとなり、これはApiaryの主要な移行先の中で最も低いシートあたりの価格です。
今すぐエクスポート、再設計は不要
作業の順序が重要です。まずApiaryからエクスポートし、次にBlueprintをOpenAPIに変換し、その後でゆっくりと移行先を評価してください。なぜなら、最初の2つのステップには期限がありますが、3番目のステップにはありません。準備ができたら、OpenAPIファイルをApidogにインポートすれば、午後が終わる前にドキュメント、モック、テストハーネスが手に入ります。Apidogをダウンロードするか、ブラウザで開始してください。4人チームなら費用はかかりません。Apiaryが発明したデザインファーストのワークフローは、ついにそれにふさわしいメンテナンスされたプラットフォームを手に入れることになります。