# ブランディング下書きを取得

`GET /v1/branding` · 権限 `branding:read`

環境のブランディング下書き (テーマトークン、カスタム CSS、ページテンプレート) を返します。下書きは公開されていません。ホスト型ページは最後に公開されたバージョン (`POST /v1/branding:publish`) を使用します。まだ何も書き込まれていない場合、テーマは空で、`ETag` は `"0"`、`updated_at` は `null` です。次の書き込みでは `ETag` を `If-Match` として送信してください。

## リクエスト

この操作はパス、クエリ、本文のフィールドを受け取りません。環境は認証情報から決まります。

## レスポンス

`200 OK` と環境の下書きおよび `ETag`。`theme` には設定済みのトークンのみが含まれ、未設定のトークンはプラットフォーム既定値を継承します。

```json
{
  "theme": {"mode": "light", "light": {"color": {"primary": "#0a3d91"}}, "logo_height": 40},
  "css": null,
  "page_template": null,
  "updated_at": "2026-10-05T09:30:00.123456Z"
}
```

## エラー

| HTTP | コード | 概要 |
|---|---|---|
| 401 | `unauthenticated` | 認証情報がない、無効、または失効しています。 |
| 403 | `insufficient_permissions` | 認証情報に必要な権限がありません。 |
| 429 | `rate_limited` | レート制限を超えました。`Retry-After` の期間後に再試行してください。 |
| 503 | `service_unavailable` | 依存サービスが一時的に利用できません。`Retry-After` の期間後に再試行してください。 |

## 例

```bash
curl https://api.eu.keenauth.com/v1/branding \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```