Authentifizierung

Alle Connector-Endpoints verwenden API Keys zur Authentifizierung.

API Key Typen

Typ	Prefix	Verwendung
Live Key	vt_live_	Produktion — echte Simulation
Test Key	vt_test_	Entwicklung — kein Effekt auf Simulation

Key im Request

POST /v1/connector/{company_id}/actions
Authorization: Bearer vt_live_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Key erstellen

Im Venturo Dashboard: Connector → API Keys → Neu erstellen

WARNING

API Keys werden nur einmal angezeigt — direkt nach der Erstellung. Danach nur noch der Prefix sichtbar (vt_live_xxxx).

Webhook-Signatur

Ausgehende Webhooks werden mit HMAC-SHA256 signiert:

X-Venturo-Signature: sha256=<hmac>

Verifikation:

$expected = 'sha256=' . hash_hmac('sha256', $rawBody, $webhookSecret);
$valid = hash_equals($expected, $signature);