釈明根拠ログ照会
指定した釈明リクエストに添付された根拠ログを、スキーマ単位でページング照会します。schema_code を指定すると当該スキーマの表示名にフィールドがマッピングされたレコードが返され、スキーマ未マッピングのログは schema_code に _ を指定して照会します。
必要な権限
MEMBER以上のロールが必要です。メールで送信された有効な釈明トークンを token パラメータに指定すると、未ログイン状態でも呼び出せます。
HTTPリクエスト
GET /api/sonar/explanation-requests/:guid/logs
cURL例
curl -H "Authorization: Bearer <API_KEY>" \
"https://HOSTNAME/api/sonar/explanation-requests/a1b2c3d4-e5f6-7890-abcd-ef1234567890/logs?type=EXPLANATION&schema_code=ssh_login&offset=0&limit=20"
リクエストパラメータ
パスパラメータ
| キー | 型 | 説明 | 備考 |
|---|---|---|---|
| guid | 文字列 | 釈明リクエスト識別子 | 36文字のGUID |
リクエスト本文パラメータ
| キー | 必須 | 型 | 説明 | 備考 |
|---|---|---|---|---|
| type | O | 文字列 | 釈明種別。EXPLANATION、MANAGER_COMMENT、AUDITOR_COMMENT のいずれか | |
| schema_code | O | 文字列 | ログスキーマコード。スキーマ未マッピングのログを照会する場合は _ を指定 | |
| offset | O | 64ビット整数 | スキップするレコード数 | 0 以上 |
| limit | O | 32ビット整数 | 返却する最大レコード数 | 0 以上 1000 以下 |
| token | X | 文字列 | 未ログイン呼び出し時に使用する釈明トークン。役職員または一次レビュアーへメールで発行されたトークン |
正常応答
{
"count": 2,
"total_count": 12,
"records": [
{
"_time": "2026-04-14T22:15:00+0900",
"送信元IP": "192.0.2.10",
"ユーザ": "admin"
},
{
"_time": "2026-04-14T22:18:30+0900",
"送信元IP": "192.0.2.10",
"ユーザ": "admin"
}
],
"field_order": ["送信元IP", "ユーザ"]
}
- count (32ビット整数): 今回の応答に含まれるレコード数
- total_count (64ビット整数): 条件に該当する全レコード数
- records (配列): 根拠ログレコードの配列。スキーママッピングがある場合、キーはスキーマフィールドの表示名に変換される。マッピングがない場合(
schema_codeが_)は元のフィールド名が使用される - field_order (配列): スキーマフィールドの表示順序。スキーママッピングがある場合のみ含まれる
エラー応答
必須パラメータが不足している場合
HTTPステータスコード 400 応答
{
"error_code": "null-argument",
"error_msg": "guid should be not null"
}
offset が負数の場合
HTTPステータスコード 500 応答
{
"error_code": "illegal-argument",
"error_msg": "offset should be positive: -1"
}
limit が1000を超えている場合
HTTPステータスコード 500 応答
{
"error_code": "illegal-argument",
"error_msg": "limit should be smaller than 1000: 5000"
}
存在しないスキーマコードを指定した場合
HTTPステータスコード 500 応答
{
"error_code": "illegal-argument",
"error_msg": "invalid schema code: unknown_schema"
}
権限がない、またはトークンが無効な場合
HTTPステータスコード 500 応答
{
"error_code": "illegal-state",
"error_msg": "no-permission"
}