调用 Agentic API 操作
签发 OAuth 访问令牌，在公开目录中找到操作，并通过 POST /api/v1/actions/<id> 调用它。
4 个步骤curlHTTP
免费开始
Trustvice 360
Trustvice 360声明规则，让每次运行都接受检查。
智能体、证据、治理、商务和披露都在 Trustvice 360 中。免费注册，在一个仪表板中打开所有套件。
签发 OAuth 访问令牌，在公开目录中找到操作，并通过 POST /api/v1/actions/<id> 调用它。
智能体、证据、治理、商务和披露都在 Trustvice 360 中。免费注册，在一个仪表板中打开所有套件。
您希望一个自动调用方（智能体或脚本）使用 Trustvice 的某项功能。每项功能都是一个已注册的操作，具有固定的 ID、带类型的输入和相同的响应信封，因此一种请求格式即可覆盖全部操作。
tvc_… ID 及其密钥）curl代码从环境变量中读取密钥。请将其保存在 shell 或密钥存储中，切勿写入要提交的文件。操作调用还需要发送 X-Workspace-Id。
使用 client_credentials 将 OAuth 客户端的 ID 和密钥换成访问令牌。令牌有效期为一小时（expires_in: 3600），并带有该客户端的权限范围。将其导出为 TRUSTVICE_TOKEN。
每个操作都以相同的信封响应：ok: true 加 data，或 ok: false 加 error 中的代码和消息。
{ "ok": true, "data": { …action output… } }
{ "ok": false, "error": { "code": "not_found", : } }401 unauthenticated，绝不会出现半认证的请求。403 permission_denied，并准确指出所需的权限。
Trustvice 360：用签名、可验证的证据来信任并治理您的 AI 智能体。
Digital Trust. On the Record.
面向软件即服务（Software‑as‑a‑Service）的
创新平台。
curl -sS -X POST https://api.trustvice.com/api/v1/oauth/token \
-H "Content-Type: application/json" \
-d "{\"grant_type\":\"client_credentials\",\"client_id\":\"tvc_…\",\"client_secret\":\"$TRUSTVICE_CLIENT_SECRET\"}"POST /api/v1/oauth/token
{ "grant_type": "client_credentials",
"client_id": "tvc_…", "client_secret": "…" }已注册操作的公开目录位于 GET /api/v1/actions，无需凭据。操作 ID 是分层的：<domain>.<noun>.<verb>。API 参考列出了每个操作的输入架构和权限。
curl -sS https://api.trustvice.com/api/v1/actions将操作的输入以 JSON 发送到 POST /api/v1/actions/<action-id>，并附上访问令牌和工作区 ID。这里会有意拒绝工作区 API 密钥：API 密钥授予的是工作区访问权限，而不是智能体的意图。
curl -sS -X POST https://api.trustvice.com/api/v1/actions/<action-id> \
-H "Authorization: Bearer $TRUSTVICE_TOKEN" \
-H "X-Workspace-Id: ws_…" \
-H "Content-Type: application/json" \
-d '{ … }'POST /api/v1/actions/<action-id>
Authorization: Bearer <oauth-access-token>
X-Workspace-Id: ws_…
Content-Type: application/json
{ …input fields… }先读取 ok。成功时输出在 data 中；失败时 error 包含机器可读的 code 和一句供人阅读的说明。业务层面的 404 或 422 是产品给出的答复，而不是传输错误。
内容复制自: /docs/actions
Idempotency-Key 请求头。412 confirmation_required。以上每一条说明都来自本页链接的 Trustvice 文档。如果文档页面写得更详细，以文档为准。
处理 412 confirmation_required：签发确认令牌，并带上 X-Trustvice-Confirmation 重新调用。
当我们向实用示例中添加新示例时，会发送一封简短的邮件。不会发送其他任何邮件，而且您可以从任意一封邮件中退订。
每个已注册的操作对应一个 POST 端点，通过 REST 和 MCP 调用时行为相同。文档列出了每个操作的输入和权限。