> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# エラーリファレンス

> Living Security の /v1 パブリック API が返す可能性のあるすべてのエラーについて、安定したマシンコード、HTTP ステータス、および解決方法を説明します。

`/v1` のすべてのエラーレスポンスは `application/problem+json`（[RFC 9457](https://www.rfc-editor.org/rfc/rfc9457)）形式であり、固定のフィールドセットで構成されます。

```json theme={null}
{
  "type": "https://docs.livingsecurity.com/developers/v1/errors/resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "No such organization.",
  "code": "resource_not_found",
  "request_id": "req_...",
  "doc_url": "https://docs.livingsecurity.com/developers/v1/errors/resource_not_found",
  "retryable": false
}
```

処理の分岐には必ず `code` を使用し、`detail` は使用しないでください。`code` は安定したマシンコントラクトであり、`detail` は人が読むためのものであり、変更される場合があります。`param` は、エラーが特定のリクエストパラメーターに起因する場合に含まれます。サポートに問い合わせる際は、`request_id` を含めてください。

## エラーコード

| コード | HTTP ステータス | 再試行可否 |
| - | - | - |
| [`unauthorized`](/ja/developers/v1/errors/unauthorized) | 401 | 不可 |
| [`credential_inactive`](/ja/developers/v1/errors/credential_inactive) | 401 | 不可 |
| [`credential_expired`](/ja/developers/v1/errors/credential_expired) | 401 | 不可 |
| [`credential_revoked`](/ja/developers/v1/errors/credential_revoked) | 401 | 不可 |
| [`not_entitled`](/ja/developers/v1/errors/not_entitled) | 403 | 不可 |
| [`insufficient_permission`](/ja/developers/v1/errors/insufficient_permission) | 403 | 不可 |
| [`permission_denied`](/ja/developers/v1/errors/permission_denied) | 403 | 不可 |
| [`resource_not_found`](/ja/developers/v1/errors/resource_not_found) | 404 | 不可 |
| [`invalid_request`](/ja/developers/v1/errors/invalid_request) | 400 または 409 | 不可 |
| [`invalid_filter`](/ja/developers/v1/errors/invalid_filter) | 400 | 不可 |
| [`unsupported_version`](/ja/developers/v1/errors/unsupported_version) | 400 | 不可 |
| [`idempotency_key_reuse`](/ja/developers/v1/errors/idempotency_key_reuse) | 409 | 競合の内容による |
| [`rate_limited`](/ja/developers/v1/errors/rate_limited) | 429 | 可 |
| [`service_unavailable`](/ja/developers/v1/errors/service_unavailable) | 503 | 可 |
| [`internal_error`](/ja/developers/v1/errors/internal_error) | 500 | 可 |

コードセットは固定されています。新しいコードの追加はパブリックコントラクトの変更にあたり、API の変更履歴を通じて告知されます。`retryable: true` レスポンスは、状況が解消される可能性があることを意味しますが、書き込みが何の影響も及ぼさなかったことを保証するものではありません。読み取りリクエストは、試行回数と所要時間に上限を設け、指数バックオフとジッターを用いて再試行してください。再試行可能な `409` や `429` の場合を含め、`Retry-After` が存在するときはそれに従ってください。

変更操作については、その操作に関して文書化されている冪等性およびリカバリーのコントラクトに従ってください。サポートされている場合は、元のキーとリクエストを保持してください。タイムアウトや `5xx` の後に新しいキーを作成しないでください。成功済みの書き込みが重複して実行される可能性があります。`Idempotency-Key` ヘッダーは、それをサポートしていない操作では何の保護も提供しません。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.