1.7　APIの記述形式

機能

APIの機能について説明します。

権限

APIを実行できる権限およびロールを示します。

APIのバージョン

APIのバージョンを示します。

リクエスト形式

APIを使用する際のリクエスト形式について説明しています。

ステータスコード

httpプロトコルまたはhttpsプロトコルを使用してAPIを実行したあとのステータスコードについて説明します。APIを実行する前にエラーになった場合のステータスコードについては，「1.2.6　ステータスコード」を参照してください。

レスポンスのスキーマ

APIが正常終了したときに返却するレスポンスのスキーマ情報について説明します。

使用例

APIを使用するためのリクエスト例およびレスポンス例について説明します。

ただし，ここでは，httpプロトコルを使用している場合の例を記載します。httpsプロトコルを使用する場合は，「HTTP」を「HTTPS」に読み替えてください。