5

API ブループリントまたは Apiary.io は、API のバージョン管理の概念をサポートしていますか? 特に、次のように URI を介して API をバージョン管理しています。

GET /api/v2/SomeResource/

上記の例では、API のバージョン 2 (「v2」) を呼び出していることを意味します。APIブループリントはこれをサポートしていますか? 特定のアクションまたは API 全体の複数のバージョンを文書化するにはどうすればよいですか?

4

1 に答える 1

6

HOSTヘッダーを使用して、次のことを示すことができます。

HOST: http://example.com/api/v2すべてのリソースの前に/api/v2.

API ブループリントでは、URL プレフィックスを使用する場合、API は異なるものと見なされるため、異なるブループリントを使用する必要があります。

これを行うためにバージョンサフィックス付きのメディアタイプを使用する場合、ヘッダーで適切に指定するだけContent-Typeで、モックサーバーでのコンテンツネゴシエーションに適切に使用されます.

于 2015-09-06T12:16:06.953 に答える