Kunden-API
Entwickler
Unternehmen, Stadt oder Ministerium können sich registrieren, 200 Test-Credits erhalten, einen eigenen Schlüssel erzeugen und die Plattform aufrufen. Ein Credit = ein Agentenlauf. Kein Kartenshop — Zahlung in Produktion per SEPA / Rechnung.
- Konto anlegen. Das 30-Tage-Testguthaben wird automatisch eröffnet.
- API-Konsole öffnen, X-GRV-Key erzeugen und einmal kopieren.
- POST /api/v1/run mit dem Schlüssel. Danach Developer-Plan, Token-Paket oder Stadt-Pilot.
Beispiel
curl -s http://localhost:3000/api/v1/run \
-H "Content-Type: application/json" \
-H "X-GRV-Key: grv_live_YOUR_KEY" \
-d '{"agent":"twin","action":"snapshot","payload":{"city":"vienna"}}'Endpunkte
GET /api/v1/health— Erreichbarkeit, ohne SchlüsselGET /api/v1/agents— Agenten, die ein Kundenschlüssel aufrufen darfGET /api/v1/me— Plan und RestguthabenPOST /api/v1/run— einen öffentlichen Agenten ausführen (1 Credit)
Rechnung, LinkedIn-Publish und Vergabe bleiben von diesem Schlüssel aus. Das sind Admin-Aktionen.