Skip to main content
Mit der Partner-API nutzt du Delicious AI als Chat-Backend für ein eigenes Frontend. Tools, Prompts und Datenzugriff laufen auf unserer Seite. Du bekommst die Antwort als Stream.

​
Base URL

Die API arbeitet auf denselben Daten wie die Delicious Data App. Der Nutzer sieht hier genau das, was er auch in der App sieht.

​
Authentifizierung

Jeder Request braucht das Access Token des Nutzers als Bearer Token. Das Token identifiziert den Nutzer und sein Unternehmen.
1

Token kopieren

In der Delicious Data App unter Einstellungen → Benutzerkonto → API-Token auf Token kopieren klicken.
2

Im Playground verwenden

Auf jeder Endpoint-Seite rechts unter Authorization einfügen und den Request absenden.
Das Token ist das Session-Token des Nutzers. Es gilt bis zu sechs Tage und wird beim Logout aus der App ungültig. Wer das Token hat, hat die Rechte des Nutzers.

​
Token in einer eigenen Anwendung

Eine Anwendung holt sich das Token über den Connect-Flow:
  1. Die Anwendung leitet den Nutzer zu https://app.delicious-data.com/partner/connect?ref=<Callback-URL> weiter.
  2. Der Nutzer meldet sich an (falls nötig) und bestätigt die Verbindung.
  3. Die App leitet zurück zur Callback-URL, mit dem Token im URL-Fragment: https://deine-app.example/connect#token=<token>
Die Anwendung liest das Token aus dem Fragment, speichert es und entfernt es aus der URL. Das Fragment wird nicht an den Server übertragen. Die Origin der Callback-URL muss bei uns registriert sein (dieselbe Liste, die CORS erlaubt). Schick uns die Origins deiner Deployments.
Für den Produktivbetrieb ersetzen wir diesen Flow durch OAuth 2.0 (Authorization Code mit PKCE), mit Refresh Tokens und einer eigenen Client-ID pro Partner.

​
Erster Chat

Chat anlegen, Nachricht senden. Die Antwort kommt als Stream.
Das Stream-Format steht unter Streaming, alle Routen unter Endpunkte.

​
Fehler

Fehler kommen als JSON mit code und message. Zwei Fehler kommen aus der Auth-Schicht und haben nur eine message:

​
CORS

Browser-Clients brauchen eine registrierte Origin. Die Registrierung gilt gleichzeitig für den Connect-Flow.