# 证明

读取已封存的决策，导出审计档案或单项决策的档案，获取用于验证回执的公钥，并读取 Azoth Guard 的证据和工作区的事件。

[完整的 API 参考](https://www.azothos.ai/zh/docs/api)

> 路由摘要和字段名称均以英文撰写，本页与文件中都是如此。

## /api/v1/journal

### GET /api/v1/journal

The sealed decisions of the workspace

- **认证** — API 密钥
- **密钥作用域** — `journal:read`
- **模块** — 在部署运行 `FEATURE_DECISION_JOURNAL` 时提供。
- **参数** — `actorId` · `agentId` · `model` · `surface` · `hasTools` · `from` · `to` · `minCostEur` · `limit` · `offset`
- **应答** — `200` · `400` [validation_failed](https://www.azothos.ai/zh/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/zh/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/zh/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/zh/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/zh/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/zh/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/zh/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/zh/docs/errors#feature_disabled)

### GET /api/v1/journal/export

The evidence pack, or the signed audit dossier as a ZIP

- **认证** — API 密钥
- **密钥作用域** — `journal:read`
- **模块** — 在部署运行 `FEATURE_DECISION_JOURNAL` 时提供。
- **参数** — `actorId` · `agentId` · `model` · `surface` · `hasTools` · `from` · `to` · `minCostEur` · `format` · `lang`
- **应答** — `200` · `400` [validation_failed](https://www.azothos.ai/zh/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/zh/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/zh/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/zh/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/zh/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/zh/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/zh/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/zh/docs/errors#feature_disabled) · `503` [dossier_signature_unavailable](https://www.azothos.ai/zh/docs/errors#dossier_signature_unavailable)

## /api/v1/decisions

### POST /api/v1/decisions/export

The decision dossier of one business decision, as a ZIP

- **认证** — API 密钥
- **密钥作用域** — `journal:read`
- **模块** — 在部署运行 `FEATURE_DECISION_DOSSIER` 时提供。
- **请求体** — `ref` (必填)
- **应答** — `200` · `400` [validation_failed](https://www.azothos.ai/zh/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/zh/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/zh/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/zh/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/zh/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/zh/docs/errors#ip_not_allowed), [plan_required](https://www.azothos.ai/zh/docs/errors#plan_required) · `404` [decision_not_found](https://www.azothos.ai/zh/docs/errors#decision_not_found) · `429` · `500` [internal_error](https://www.azothos.ai/zh/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/zh/docs/errors#feature_disabled) · `503` [dossier_signature_unavailable](https://www.azothos.ai/zh/docs/errors#dossier_signature_unavailable)

## /api/proof

### GET /api/proof/keys/{workspaceId}

A workspace's public receipt keys (JWKS)

- **认证** — 无：公开
- **参数** — `workspaceId` (必填)
- **应答** — `200` · `400` [validation_failed](https://www.azothos.ai/zh/docs/errors#validation_failed) · `429` · `500` [internal_error](https://www.azothos.ai/zh/docs/errors#internal_error) · `503` [service_unavailable](https://www.azothos.ai/zh/docs/errors#service_unavailable)

## /api/v1/guard

### GET /api/v1/guard/evidence

Azoth Guard's evidence pack, by obligation

- **认证** — API 密钥
- **密钥作用域** — `journal:read`
- **模块** — 在部署运行 `FEATURE_GUARD_EVIDENCE_PACK` 时提供。
- **参数** — `from` · `to` · `category` · `severity` · `limit`
- **应答** — `200` · `401` [api_key_missing](https://www.azothos.ai/zh/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/zh/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/zh/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/zh/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/zh/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/zh/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/zh/docs/errors#feature_disabled)

## /api/v1/incidents

### GET /api/v1/incidents

The workspace's incidents

- **认证** — API 密钥
- **密钥作用域** — `journal:read`
- **模块** — 在部署运行 `FEATURE_INCIDENT_MODE` 时提供。
- **应答** — `200` · `401` [api_key_missing](https://www.azothos.ai/zh/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/zh/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/zh/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/zh/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/zh/docs/errors#ip_not_allowed), [plan_required](https://www.azothos.ai/zh/docs/errors#plan_required) · `429` · `500` [internal_error](https://www.azothos.ai/zh/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/zh/docs/errors#feature_disabled) · `503` [service_unavailable](https://www.azothos.ai/zh/docs/errors#service_unavailable)

### POST /api/v1/incidents/{id}/match

Which of your business references an incident touched

- **认证** — API 密钥
- **密钥作用域** — `journal:read`
- **模块** — 在部署运行 `FEATURE_INCIDENT_MODE` 时提供。
- **参数** — `id` (必填)
- **请求体** — `refs` (必填)
- **应答** — `200` · `400` [validation_failed](https://www.azothos.ai/zh/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/zh/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/zh/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/zh/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/zh/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/zh/docs/errors#ip_not_allowed), [plan_required](https://www.azothos.ai/zh/docs/errors#plan_required) · `404` [incident_not_found](https://www.azothos.ai/zh/docs/errors#incident_not_found) · `429` · `500` [internal_error](https://www.azothos.ai/zh/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/zh/docs/errors#feature_disabled) · `503` [service_unavailable](https://www.azothos.ai/zh/docs/errors#service_unavailable)
