3. 表記規則¶

Tower では標準 REST API を使用し、サーバー上の /api/ を root とします。API は互換性目的でバージョン別となっており、現行では /api/v1/ と api/v2/ が利用可能です。/api/ にクエリーを実行すると、利用可能なバージョンが確認できます。

バージョンに基づいて、POST または PUT リクエストでのコンテンツ/タイプを指定する必要がある場合があります。

• PUT: (識別子による) 特定のリソースもしくはリソースの集合を更新します。リソース識別子が前もって分かっている場合は、PUT を使って特定のリソースを作成することが可能です。
• POST: 新しいリソースを作成します。他のカテゴリーに該当しない演算用の汎用動詞としても機能します。

"/" で終わらない URI はすべて 301 リダイレクトを返します。