Wieso spielt mir die API keine Treffer zurück?

Wenn die DTAD-API 0 Treffer zurückgibt, liegt meist einer der folgenden Gründe vor: - Kein Suchprofil vorhanden oder neu angelegt (noch keine Ausführung verfügbar) - Falscher oder fehlender Anfrageparameter - Authentifizierungs- oder Autorisierungsproblem Prüfen Sie die folgenden Punkte der Reihe nach, um die Ursache einzugrenzen.

Suchprofilausführungen abrufen

Rufen Sie zuerst die verfügbaren Suchprofilausführungen Ihres Accounts über diesen Endpunkt ab:

GET /search-profiles/executions

Suchprofile werden einmal täglich ausgeführt, in der Regel nachts. Wenn Sie ein Profil neu angelegt oder geändert haben, ist möglicherweise noch keine Ausführung verfügbar – warten Sie in diesem Fall die nächste Ausführung ab. Der genaue Zeitpunkt kann je nach Systemauslastung leicht variieren.

Anzahl der Ergebnisse prüfen

Kontrollieren Sie in der Antwort den Wert totalResults. Er zeigt, wie viele Treffer die jeweilige Suchprofilausführung enthält.

Steht der Wert auf 0, hat das Suchprofil bei dieser Ausführung keine passenden Dokumente gefunden. Überprüfen Sie in diesem Fall das Suchprofil und seine Konfiguration direkt in der DTAD-Oberfläche, um sicherzustellen, dass die Suchkriterien korrekt definiert sind. Achten Sie dabei besonders auf zu enge Filterkriterien wie eingeschränkte Regionen, Dokumenttypen oder Schlüsselwörter.

Richtige Ausführungs-ID verwenden

Die einzelnen Treffer einer Ausführung rufen Sie über folgenden Endpunkt ab:

GET /search-profiles/executions/{id}

Verwenden Sie für {id} den Wert des Feldes _id aus einer zuvor über GET /search-profiles/executions abgerufenen Suchprofilausführung. Die ID des Suchprofils selbst ist hier nicht gültig.

Seitennummer und Limit kontrollieren

Die Endpunkte für Suchprofilausführungen und deren Ergebnisse sind paginiert. Das bedeutet, dass die Daten auf mehrere Seiten verteilt sein können.

Prüfen Sie deshalb die Parameter:

• page: angefragte Seite (Standard: 1)
• limit: Anzahl der Ergebnisse pro Seite (Standard: 20)
• currentPage: aktuell zurückgegebene Seite
• totalPages: insgesamt verfügbare Seiten

Wenn Sie eine Seite außerhalb der verfügbaren Seiten anfragen, erhalten Sie möglicherweise keine Treffer. Beginnen Sie den Test daher mit page=1.

Autorisierten Account prüfen

Die DTAD-API liefert nur Suchprofilausführungen und Ergebnisse für den aktuell autorisierten Account. Stellen Sie sicher, dass Sie den passenden API-Zugang verwenden und ein gültiges, nicht abgelaufenes JWT (JSON Web Token) als Bearer-Token im Authorization-Header mitsenden. Wie Sie ein neues JWT beziehen, erfahren Sie in der Authentifizierungsdokumentation.

Prüfen Sie außerdem den HTTP-Statuscode der Antwort:

• 200: Anfrage wurde erfolgreich verarbeitet.
• 403 Forbidden: Der Zugriff ist nicht autorisiert. Prüfen Sie, ob das JWT gültig ist und zum richtigen Account gehört.
• 404 Not Found: Es wurden keine passenden Suchprofilausführungen gefunden, oder die angegebene Ausführungs-ID existiert nicht. Stellen Sie sicher, dass die verwendete _id aus dem Ergebnis von GET /search-profiles/executions stammt.
• 500 Internal Server Error: Bei der Verarbeitung ist ein interner Fehler aufgetreten. Versuchen Sie die Anfrage erneut. Besteht das Problem weiterhin, wenden Sie sich bitte an den DTAD-Support.