Wie implementiere ich die DTAD-API?

Die DTAD API bietet Ihnen eine flexible und passgenaue Anbindung an Ihre bestehenden Systeme. Die technische Integration erfolgt durch Ihre eigenen Entwickler mit entsprechender Expertise oder durch einen von Ihnen beauftragten Dienstleister. Dank der übersichtlichen Dokumentation unter docs.dtad.com lässt sich die individuelle Anbindung einfach und unkompliziert umsetzen.

1. API-Zugangsdaten erhalten

Ihre CLIENT_ID und CLIENT_SECRET erhalten Sie durch Ihr DTAD Customer Success Team.Bewahren Sie das CLIENT_SECRET geschützt auf und veröffentlichen Sie es nicht im Quellcode oder in öffentlich zugänglichen Systemen.

2. JWT erzeugen

Fordern Sie mit Ihrer CLIENT_ID und Ihrem CLIENT_SECRET ein JWT an:

curl --location 'https://dtad-next-prod.auth.eu-central-
1.amazoncognito.com/oauth2/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=CLIENT_ID' \
--data-urlencode 'client_secret=CLIENT_SECRET'

Ersetzen Sie CLIENT_ID und CLIENT_SECRET durch die bereitgestellten Zugangsdaten. Das JWT ist 120 Minuten gültig. Fordern Sie anschließend ein neues Token an.

3. Authentifizierung übermitteln

Übermitteln Sie das JWT bei Ihren API-Aufrufen im Header Authorization.

4. API-Endpunkt aufrufen

Die Basis-URL der DTAD API lautet:

https://api.dtad.com

Je nach benötigten Daten steht eine Vielzahl von GET-Endpunkten zur Verfügung. Die vollständige URL setzt sich aus der Basis-URL und dem jeweiligen Endpunkt zusammen:

https://api.dtad.com/search-profiles/executions

Ausführliche Informationen zu den Endpunkten, Parametern und Antwortfeldern finden Sie in der DTAD API-Dokumentation.

5. Seitennummerierung berücksichtigen

Mehrere Endpunkte liefern paginierte Ergebnisse. Das bedeutet, dass die Datensätze auf mehrere Seiten verteilt werden. Dafür können Sie die Parameter page und limit verwenden:

https://api.dtad.com/search-profiles/executions?page=1&limit=25

Beim Endpunkt für Suchprofilausführungen beträgt der Standardwert für limit 25 und der Höchstwert 100. Die Antwort enthält unter anderem totalPages und currentPage. Anhand dieser Werte erkennen Sie, ob weitere Seiten verfügbar sind.

6. Antworten und Fehler verarbeiten

Die API liefert Daten im JSON-Format. Berücksichtigen Sie bei der Integration insbesondere folgende Statuscodes:

200: Die Anfrage war erfolgreich.
403: Der Zugriff ist nicht autorisiert oder nicht erlaubt.
404: Die angeforderten Daten wurden nicht gefunden.
500: Ein interner Serverfehler ist aufgetreten.

Prüfen Sie bei einem Statuscode 403, ob das JWT noch gültig ist und die erforderlichen Authentifizierungsheader korrekt übermittelt wurden.

Hinweis zu Anhängen

Der Endpunkt GET /attachments/{id} erzeugt einen öffentlichen Download-Link für den jeweiligen Anhang. Dieser Link bleibt nach seiner Erstellung 120 Sekunden gültig und sollte deshalb direkt verwendet werden.