Warum sind meine Crawls fehlgeschlagen?

Crawls können aus drei Gründen fehlschlagen: die Quell-API ist down, deine Credentials sind abgelaufen, oder das Schema hat sich seit dem letzten Crawl geändert. Der Quellen → Crawl History-Tab zeigt für jeden Run, welcher Fall aufgetreten ist.

Auth-Fehler (401, 403)

Häufigste Ursache. API-Keys laufen ab oder werden bei den meisten SaaS-Anbietern rotiert.

So behebst du es:

1. Öffne die Quelle in Quellen → [dein Quellen-Name].
2. Klick auf Credentials bearbeiten.
3. Füge den frischen Key oder Token ein.
4. Klick auf Verbindung testen — wenn grün, klick auf Speichern und neu crawlen.

Rate-Limit-Fehler (429)

Die API hat dein Limit-Fenster überschritten. Wir respektieren die Retry-After-Header der Anbieter und reentern automatisch — kannst du im Crawl-History-Log sehen. Wenn ein Crawl 24 h auf einem 429 hängenbleibt, hat der Anbieter dich wahrscheinlich vollständig gedrosselt; wende dich an dessen Support.

Schema-Drift-Fehler

Manchmal ändert eine Quell-API ihre Antwortstruktur — eine Spalte verschwindet, oder ein neues verschachteltes Objekt erscheint. Der Crawl bricht nicht ab, aber das Reconciliation-Tool kennzeichnet alle Tabellen mit Drift.

So behebst du es:

1. Öffne Quellen → [Quelle] → Reconciliation.
2. Sieh dir die Drift entdeckt-Liste an.
3. Klick Schema akzeptieren, um das aktuelle als neue Wahrheit zu setzen, oder Mapping bearbeiten, um Spalten manuell zuzuordnen.

Netzwerkfehler (Timeouts, DNS, 5xx)

Vorübergehende Probleme aufseiten der Quell-API. Wir versuchen jeden gescheiterten Endpoint dreimal mit exponential Backoff erneut. Wenn alle drei fehlschlagen, markieren wir die Tabelle für diesen Run als gescheitert und versuchen es im nächsten geplanten Crawl erneut. Du musst nichts tun.

Komplett-Failures

Wenn ein ganzer Crawl 0 Zeilen hat, hat die API höchstwahrscheinlich völlig die Form geändert (z. B. Migration auf v2). Lösche die Quelle und füge sie neu hinzu — der Connector erkennt das aktualisierte Schema und mappt sauber neu.

Hilfe holen

Wenn du steckenbleibst, klick neben der gescheiterten Quelle auf Crawl-Diagnostik exportieren. Das exportiert eine JSON-Datei mit Endpoint-für-Endpoint-Details. Schick sie an support@harbingerexplorer.com und wir antworten innerhalb eines Werktags.