Integration

API-Referenz

Baue eigene Integrationen direkt gegen die Y.olo-API. Alle Endpunkte sind REST/JSON, per Bearer-Token authentifiziert und in der Swagger/OpenAPI-Spec vollständig dokumentiert.

Basis-URL & Authentifizierung

Alle Aufrufe gehen an https://api.getyourloop.de. Authentifiziert wird per Bearer-Token im Authorization-Header:

Authorization: Bearer <DEIN_JWT>

Webhook-Trigger sind die Ausnahme: Sie nutzen statt des JWT einen eigenen X-Trigger-Token, damit Fremdsysteme feuern können, ohne ein Nutzerkonto zu brauchen.

Vollständige Referenz (Swagger / OpenAPI)

Die interaktive OpenAPI-Dokumentation mit allen Endpunkten, Schemata und Beispielantworten findest du unter https://api.getyourloop.de/docs. Jeder Webhook-Trigger stellt zusätzlich unter GET /api/v1/triggers/{id}/openapi eine eigene Spec bereit.

End-to-End: Trigger → Run → Decision

Der typische Weg von einem eingehenden Ereignis bis zur freigabebereiten Entscheidung:

bash
# 1 · Workflow auslösen (Webhook-Trigger)
curl -X POST https://api.getyourloop.de/api/v1/webhook/<TRIGGER_ID> \
  -H "X-Trigger-Token: <TRIGGER_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{ "subject": "Angebotsanfrage", "message": "…", "sender": "kunde@example.de" }'
# → 202 { "task_id": "…", "status": "accepted" }

# 2 · Run-Status verfolgen
curl https://api.getyourloop.de/api/v1/inbound/task/<TASK_ID> \
  -H "Authorization: Bearer <DEIN_JWT>"
# → state: PENDING → SUCCESS, liefert die decision_id

# 3 · Entscheidung abrufen (erscheint in der Inbox zur Freigabe)
curl https://api.getyourloop.de/api/v1/decisions/<DECISION_ID> \
  -H "Authorization: Bearer <DEIN_JWT>"

Integrität prüfen

Jede Entscheidung ist Teil einer SHA-256-Hash-Kette. Die Integrität einer einzelnen Entscheidung prüfst du jederzeit:

bash
curl -X POST https://api.getyourloop.de/api/v1/decisions/<DECISION_ID>/verify-chain \
  -H "Authorization: Bearer <DEIN_JWT>"
# → { "ok": true }

Weiter

WebhooksFAQ & Fehlerbehebung