Emita um token de acesso OAuth, encontre uma ação no catálogo público e chame-a em POST /api/v1/actions/<id>.
Agentes, evidências, governação, comércio e divulgação estão no Trustvice 360. Registe-se grátis e abra todas as suítes a partir de um só painel.
© 2026 Trustvice. Todos os direitos reservados. Trustvice é um produto da Trustvice. Secured and supercharged by Avonao Labs.
Denunciar abusoVocê quer que um chamador automático, um agente ou um script, use uma capacidade da Trustvice. Cada capacidade é uma ação registrada com um id estável, uma entrada tipada e o mesmo envelope de resposta, então um só formato de requisição serve para todas.
Trustvice 360tvc_… e o seu segredo)curlO código lê os segredos de variáveis de ambiente. Guarde-os no shell ou no cofre de segredos, nunca num arquivo que vai para commit. As chamadas de ação também enviam X-Workspace-Id.
Troque o id e o segredo do seu cliente OAuth por um token de acesso com client_credentials. O token dura uma hora (expires_in: 3600) e carrega o escopo de permissões do cliente. Exporte-o como TRUSTVICE_TOKEN.
Toda ação responde no mesmo envelope: ok: true com data, ou ok: false com código e mensagem em error.
{ "ok": true, "data": { …action output… } }
{ "ok": false, "error": { "code": , : } }401 unauthenticated limpo, nunca uma requisição meio autenticada.403 permission_denied, com o nome exato da permissão exigida.
Trustvice 360: confie nos seus agentes de IA e governe-os com evidência assinada e verificável.
Digital Trust. On the Record.
A plataforma de inovação para
Software como Serviço.
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": "…" }O catálogo público de ações registradas fica em GET /api/v1/actions, sem credencial. Os ids de ação são hierárquicos: <domain>.<noun>.<verb>. A referência da API lista o esquema de entrada e as permissões de cada ação.
curl -sS https://api.trustvice.com/api/v1/actionsEnvie a entrada da ação como JSON para POST /api/v1/actions/<action-id>, com o token de acesso e o id do seu workspace. Chaves de API de workspace são recusadas aqui de propósito: uma chave de API dá acesso ao workspace, não intenção de agente.
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… }Leia ok primeiro. Em caso de sucesso, a saída está em data; em caso de falha, error traz um code legível por máquina e uma frase para pessoas. Um 404 ou 422 de domínio é o produto respondendo, não um erro de transporte.
Copiado de: /docs/actions
Idempotency-Key.412 confirmation_required.Cada afirmação acima vem das docs da Trustvice linkadas nesta página. Onde uma página das docs diz mais, ela é a referência.
Trate 412 confirmation_required: emita um token de confirmação e repita a chamada com X-Trustvice-Confirmation.
Um e-mail curto quando somamos receitas. Nenhum outro e-mail, e você cancela por qualquer mensagem.
Um endpoint POST por ação registrada, com o mesmo comportamento via REST e MCP. As docs listam cada ação com sua entrada e permissões.