API-Referenz
Die vollständige DaRetriva REST-API — jeder von der App selbst genutzte Endpunkt, direkt aus dem Live-Schema generiert, sodass sie nie veraltet ist.
ReDoc-Referenz →
Übersichtliche, schreibgeschützte durchsuchbare Referenz. Bester Ausgangspunkt zur Erkundung von Endpunkten und Schemas.
Interaktive Swagger-UI →
Dieselbe Referenz, aber Sie können sich authentifizieren und echte Anfragen direkt aus dem Browser senden.
OpenAPI-Schema →
Rohe openapi.json — importieren Sie sie in Postman, Insomnia oder ein beliebiges Codegen-Tool.
Authentifizierung
Melden Sie sich an, um ein Bearer-JWT zu erhalten, und senden Sie es bei jeder weiteren Anfrage. Tokens laufen standardmäßig nach 24 Stunden ab; rufen Sie den Logout-Endpunkt auf, um eines vorzeitig zu widerrufen.
curl -X POST https://daretriva.com/api/organization/login \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com","password":"••••••••"}'
# → { "token": "eyJhbGciOi...", "email": "you@example.com", ... }
curl https://daretriva.com/api/agents \
-H "Authorization: Bearer eyJhbGciOi..."Ihre KI-Agenten auflisten
curl https://daretriva.com/api/agents \
-H "Authorization: Bearer $TOKEN"Ein Dokument hochladen
curl -X POST https://daretriva.com/api/upload \
-H "Authorization: Bearer $TOKEN" \
-F "file=@handbook.pdf" \
-F "dataset_id=your-dataset-id"Mit einem öffentlichen Widget chatten (ohne Authentifizierung)
Widget-Endpunkte sind nicht authentifiziert — beschränkt auf den einen Agenten hinter dem öffentlichen Token. Siehe den Leitfaden zur Widget-Integration.
curl -X POST https://daretriva.com/api/public/widget/{token}/chat \
-H "Content-Type: application/json" \
-d '{"message":"What data sources do you support?","language":"en"}'