# API 共通仕様


## 基本

| 項目 | 内容 |
|:---|:---|
| 文字コード | UTF-8 |
| Content-Type | application/json |
| Accept | application/json |
| タイムゾーン | Asia/Tokyo |
| 日時形式 | ISO 8601 形式。(e.g. `2026-06-01T12:00:00+09:00`) |


## レスポンス形式

成功 / 失敗両者とも、基本形は `data` と `message` の JSON オブジェクトです。

```json
{
    "data": {},
    "message": ""
}
```

`message` には規定 HTTP ステータスメッセージのほか、ユーザー向けの表示メッセージを入れてください。


## HTTP ステータス

| ステータス | 用途 | 規定メッセージ |
|---:|:---|:---|
| 200 | 正常終了 | `ok.` |
| 201 | 作成成功 | `created.` |
| 204 | レスポンスなし | - |
| 400 | リクエスト不正 | `Bad Request.` |
| 401 | 未認証 | `Unauthorized.` |
| 403 | 権限なし | `Forbidden.` |
| 404 | 対象なし | `Not Found.` |
| 405 | 不許可メソッド | `Method Not Allowed.` |
| 409 | リクエスト競合 | `Conflict.` |
| 422 | バリデーションエラー | `Unprocessable Entity.` |
| 500 | サーバー内部エラー | `Internal Server Error.` |
| 503 | サーバー利用不可 | `Service Unavailable.` |