Eine Agentic-API-Aktion aufrufen
Ein OAuth-Access-Token ausstellen, eine Aktion im öffentlichen Katalog finden und sie unter POST /api/v1/actions/<id> aufrufen.
Ein OAuth-Access-Token ausstellen, eine Aktion im öffentlichen Katalog finden und sie unter POST /api/v1/actions/<id> aufrufen.
Agenten, Nachweise, Governance, Handel und Offenlegung stecken in Trustvice 360. Kostenlos registrieren und alle Suiten in einem Dashboard öffnen.
Ein maschineller Aufrufer, ein Agent oder ein Skript, soll eine Fähigkeit von Trustvice nutzen. Jede Fähigkeit ist eine registrierte Aktion mit fester ID, typisierter Eingabe und demselben Antwort-Umschlag, daher deckt eine Anfrageform alle ab.
tvc_…-ID und ihr Secret)curlDer Code liest Geheimnisse aus Umgebungsvariablen. Halten Sie sie in Shell oder Secret-Store, nie in einer committeten Datei. Aktionsaufrufe senden außerdem X-Workspace-Id.
Tauschen Sie ID und Secret Ihres OAuth-Clients per client_credentials gegen ein Access-Token. Das Token gilt eine Stunde (expires_in: 3600) und trägt den Berechtigungsumfang des Clients. Exportieren Sie es als TRUSTVICE_TOKEN.
Jede Aktion antwortet im selben Umschlag: ok: true mit data oder ok: false mit error-Code und Meldung.
{ "ok": true, "data": { …action output… } }
{ "ok": false, "error": { "code": , : } }401 unauthenticated, nie eine halb authentifizierte Anfrage.403 permission_denied und nennt genau die benötigte Berechtigung.
Trustvice 360: Vertrauen Sie Ihren KI-Agenten und steuern Sie sie mit signierten, überprüfbaren Nachweisen.
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": "…" }Der öffentliche Katalog der registrierten Aktionen liegt unter GET /api/v1/actions, ohne Zugang. Aktions-IDs sind hierarchisch: <domain>.<noun>.<verb>. Die API-Referenz listet Eingabeschema und Berechtigungen jeder Aktion.
curl -sS https://api.trustvice.com/api/v1/actionsSenden Sie die Eingabe der Aktion als JSON an POST /api/v1/actions/<action-id>, mit Access-Token und Workspace-ID. Workspace-API-Schlüssel werden hier bewusst abgelehnt: Ein API-Schlüssel gewährt Workspace-Zugriff, keine Agenten-Absicht.
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… }Lesen Sie zuerst ok. Bei Erfolg steht die Ausgabe in data; bei einem Fehler trägt error einen maschinenlesbaren code und einen Satz für Menschen. Ein fachliches 404 oder 422 ist die Antwort des Produkts, kein Transportfehler.
Kopiert aus: /docs/actions
Idempotency-Key-Header.412 confirmation_required.Jede Aussage oben stammt aus den auf dieser Seite verlinkten Trustvice-Docs. Wo eine Docs-Seite mehr sagt, ist sie maßgeblich.
412 confirmation_required behandeln: ein Bestätigungstoken ausstellen und den Aufruf mit X-Trustvice-Confirmation wiederholen.
Eine kurze E-Mail, wenn wir neue Rezepte ergänzen. Sonst keine Mail, und Sie melden sich aus jeder Nachricht ab.
Ein POST-Endpunkt pro registrierter Aktion, mit gleichem Verhalten über REST und MCP. Die Docs listen jede Aktion mit Eingabe und Berechtigungen.