REST API
Release Evidenz in Ihren Workflow integrieren.
Starten Sie autorisierte Scans, lesen Sie deterministische Befunde und verifizieren Sie Änderungen über eine versionierte, mandantengebundene API.
Request Lebenszyklus
Ein Vertrag vom Token bis zur Verifikation.
Web, REST, CLI und MCP teilen Autorisierung, Regeln und Befundstatus.
Authentifizieren
Begrenztes Bearer Token und Organisationskontext.
Autorisieren
Zielbestätigung wird serverseitig gebunden.
Scannen
Ein idempotenter Request erzeugt genau einen Versuch.
Lesen
Stabile Fehlercodes und strukturierte Befunde.
Verifizieren
Dieselbe Regel wird gezielt erneut geprüft.
Implementierte MVP Ressourcen
Die zentralen Endpunkte auf einen Blick.
Die versionierte OpenAPI Datei bleibt kanonisch. Geplante Erweiterungen werden nicht als verfügbar dargestellt.
/projects/{project_id}/scansBegrenzten Scan erstellen/scans/{scan_id}Status und Zusammenfassung lesen/scans/{scan_id}/findingsDeterministische Befunde filtern/findings/{finding_id}Evidenz und Behebung lesen/findings/{finding_id}/verifyBegrenzte Verifikation anfordern/scans/{scan_id}/reports/{format}Versiegelten Bericht ladenStrikter Request
Wiederholbar, begrenzt und explizit autorisiert.
Idempotency-KeyVerhindert doppelte Scans bei exakten Wiederholungen.
X-Vybentis-Organization-IdBindet jeden Zugriff an den Tenant Kontext.
target_authorization_confirmedAkzeptiert ausschließlich den JSON Wert true.
curl --request POST \ /v1/projects/$PROJECT_ID/scans \ --header "Authorization: Bearer $TOKEN" \ --header "Idempotency-Key: scan-0001" \ --data '{"url":"https://example.com",
"locale":"en",
"target_authorization_confirmed":true}'Antwortvertrag
Klare Ergebnisse. Sichere Fehler.
Häufige Fragen
Die wichtige Grenze direkt erklärt.
Der Basispfad ist /v1. API Version und Rule Pack Version bleiben getrennt, damit Evidenz ihre exakte Regelbasis behält.
Nächster Schritt
API Evidenz im Agenten nutzen.
MCP stellt dieselben Regeln und Befunde als kleine, typisierte Werkzeuggruppe bereit.