法的文書を取得
GET /v1/legal-documents/{id} · 権限 legal-documents:read
法的文書のバージョンを 1 件返します。形式が不正な ID や別の環境の ID は 404 not_found を返します。
リクエスト
パスパラメータ:
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
id |
string | はい | 文書 ID (ldoc_…)。 |
レスポンス
200 OK と文書。
{
"id": "ldoc_01j9xk3m7q8r2s4t6v8w0y2z4a",
"application_id": null,
"kind": "terms",
"version": "2026-10",
"locale": "en",
"url": "https://example.com/legal/terms-2026-10",
"content_sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
"effective_at": "2026-11-01T00:00:00Z",
"requires_reacceptance": true,
"created_at": "2026-10-05T09:30:00.123456Z",
"updated_at": "2026-10-05T09:30:00.123456Z"
}
エラー
| HTTP | コード | 概要 |
|---|---|---|
| 404 | not_found |
文書が存在しないか、別の環境に属しています。 |
| 401 | unauthenticated |
認証情報が見つからない、無効、または取り消されています。 |
| 403 | insufficient_permissions |
認証情報に必要な権限がありません。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After 期間後に再試行してください。 |
| 503 | service_unavailable |
依存関係が一時的に利用できません。Retry-After 期間後に再試行してください。 |
例
curl https://api.eu.keenauth.com/v1/legal-documents/ldoc_01j9xk3m7q8r2s4t6v8w0y2z4a \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"