Ottieni un token di accesso OAuth, trova un’azione nel catalogo pubblico e chiamala su POST /api/v1/actions/<id>.
Agenti, prove, governance, commercio e informativa sono in Trustvice 360. Registrati gratis e apri tutte le suite da un'unica dashboard.
© 2026 Trustvice. Tutti i diritti riservati. Trustvice è un prodotto di Trustvice. Secured and supercharged by Avonao Labs.
Segnala abusoVuoi che un chiamante automatico, un agente o uno script, usi una funzionalità di Trustvice. Ogni funzionalità è un’azione registrata con un id stabile, un input tipizzato e la stessa busta di risposta, quindi un’unica forma di richiesta vale per tutte.
Trustvice 360tvc_… e il suo segreto)curlIl codice legge i segreti da variabili d’ambiente. Tienili nella shell o nel gestore di segreti, mai in un file che finisce in un commit. Le chiamate alle azioni inviano anche X-Workspace-Id.
Scambia id e segreto del tuo client OAuth con un token di accesso tramite client_credentials. Il token vale un’ora (expires_in: 3600) e porta l’ambito di permessi del client. Esportalo come TRUSTVICE_TOKEN.
Ogni azione risponde con la stessa busta: ok: true con data, oppure ok: false con codice e messaggio in error.
{ "ok": true, "data": { …action output… } }
{ "ok": false, "error": { "code": , : } }401 unauthenticated netto, mai una richiesta autenticata a metà.403 permission_denied con il nome esatto del permesso richiesto.
Trustvice 360: dia fiducia ai Suoi agenti AI e li governi con evidenza firmata e verificabile.
Digital Trust. On the Record.
La piattaforma di innovazione per
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": "…" }Il catalogo pubblico delle azioni registrate è servito su GET /api/v1/actions, senza credenziali. Gli id delle azioni sono gerarchici: <domain>.<noun>.<verb>. Il riferimento API elenca schema di input e permessi di ogni azione.
curl -sS https://api.trustvice.com/api/v1/actionsInvia l’input dell’azione come JSON a POST /api/v1/actions/<action-id>, con il token di accesso e l’id del tuo workspace. Le chiavi API di workspace qui vengono rifiutate di proposito: una chiave API dà accesso al workspace, non un’intenzione di 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… }Leggi prima ok. In caso di successo l’output è in data; in caso di errore error porta un code leggibile dalla macchina e una frase per le persone. Un 404 o 422 di dominio è il prodotto che risponde, non un errore di trasporto.
Copiato da: /docs/actions
Idempotency-Key.412 confirmation_required.Ogni affermazione qui sopra viene dalle docs di Trustvice collegate in questa pagina. Dove una pagina delle docs dice di più, fa testo quella.
Gestisci 412 confirmation_required: ottieni un token di conferma e ripeti la chiamata con X-Trustvice-Confirmation.
Una breve email quando aggiungiamo ricette. Nessun’altra posta, e ti disiscrivi da ogni messaggio.
Un endpoint POST per ogni azione registrata, con lo stesso comportamento via REST e MCP. Le docs elencano ogni azione con input e permessi.