Zu Content springen
Kontakt aufnehmen
  • Es gibt keine Vorschläge, da das Suchfeld leer ist.

Wieso spielt mir die API keine Treffer zurück?

Erfahren Sie, warum die DTAD-API keine Treffer zurückgibt und wie Sie Suchprofilausführung, Ausführungs-ID, Account und Seitennummer prüfen.

Wenn die DTAD API 0 Treffer zurückgibt, kann dies unterschiedliche Ursachen haben. Prüfen Sie die folgenden Punkte der Reihe nach.

Suchprofilausführungen abrufen

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

GET /search-profiles/executions

Suchprofile werden nachts ausgeführt. Wurde ein Profil neu angelegt oder geändert, ist möglicherweise noch keine Ausführung verfügbar. Warten Sie in diesem Fall die nächste nächtliche Ausführung ab.

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 dort 0, hat das Suchprofil bei dieser Ausführung keine passenden Dokumente gefunden. Prüfen Sie das Suchprofil und seine Treffer zusätzlich direkt in DTAD.

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} die _id einer zuvor über GET /search-profiles/executions abgerufenen Suchprofilausführung. Die ID des Suchprofils selbst ist an dieser Stelle nicht vorgesehen.

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
  • limit: Anzahl der Ergebnisse pro Seite
  • 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 API liefert nur Suchprofilausführungen und Ergebnisse für den aktuell autorisierten Account. Stellen Sie sicher, dass Sie den passenden Zugang und ein gültiges JWT verwenden.

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

  • 200: Anfrage wurde erfolgreich verarbeitet.
  • 403: Der Zugriff ist nicht autorisiert.
  • 404: Es wurden keine passenden Suchprofilausführungen beziehungsweise keine Ausführung mit der angegebenen ID gefunden.
  • 500: Bei der Verarbeitung ist ein interner Fehler aufgetreten.

💡 Rufen Sie zuerst die verfügbaren Suchprofilausführungen ab und verwenden Sie anschließend deren _id, um die enthaltenen Treffer abzufragen.

❓ Erhalten Sie weiterhin 0 Treffer, können Sie hier Kontakt aufnehmen. Senden Sie dabei nach Möglichkeit den verwendeten Endpunkt, die Anfrageparameter und den HTTP-Statuscode mit.