Fehler & Limits
Credits
Abschnitt betitelt „Credits“| Event | Charged? |
|---|---|
| Erfolgreiche Anfrage (HTTP 200) | 1 Credit |
Erfolgreiches Rendering (render_js=1) | 1 Credit |
| Fehlgeschlagene Anfrage (Timeouts, Verbindungsfehler) | 0 Credits |
| HTTP 4xx oder 5xx vom Ziel | 0 Credits |
| Wiederholungen innerhalb eines Aufrufs | Wird als einzelner übergeordneter Aufruf gezählt |
Ihnen werden nur Antworten in Rechnung gestellt, die mit einem 2xx-Status und einem nicht leeren Body bei Ihnen ankommen.
Concurrency
Abschnitt betitelt „Concurrency“| Plan | Max concurrent requests |
|---|---|
| Starter | 20 |
| Growth | 50 |
| Business | 100 |
| Enterprise | 500 |
Anfragen, die das Limit überschreiten, liefern 429 Too Many Requests. Warten Sie mit exponentieller Verzögerung und versuchen Sie es erneut.
Error codes
Abschnitt betitelt „Error codes“| Status | Meaning | What to do |
|---|---|---|
200 | Erfolg, Antwortkörper angehängt | Normal verarbeiten |
400 | Fehlerhafte Anfrage (fehlerhafte Parameter) | Beheben Sie den Parameter extract_rules oder url |
401 | Ungültiger oder fehlender api_key | Überprüfen Sie den Schlüssel im Panel |
403 | Plan erlaubt diese Funktion nicht | Upgraden Sie oder entfernen Sie das Flag (z. B. premium_proxy bei Starter) |
408 | Zielseite hat ein Timeout ausgelöst | Wiederholen Sie mit einem höheren timeout= oder einfacheren Optionen |
422 | Rendering fehlgeschlagen (JS-Absturz, Navigationsfehler) | Wiederholen Sie; prüfen Sie, ob die Seite in einem echten Browser funktioniert |
429 | Limit für gleichzeitige Anfragen überschritten | Warten Sie und versuchen Sie es erneut |
500 | Interner Fehler von Shifter | Nach kurzer Verzögerung erneut versuchen oder den Support kontaktieren, falls das Problem anhält |
509 | Plan-Guthaben aufgebraucht | Upgraden oder auf den nächsten Abrechnungszyklus warten |
Automatische Wiederholungen
Abschnitt betitelt „Automatische Wiederholungen“Fehlgeschlagene Abrufe, CAPTCHAs und vorübergehende 5xx-Fehler vom Ziel werden automatisch (bis zu 3 Mal) mit unterschiedlichen Proxys wiederholt, bevor der Endpunkt einen Fehler zurückgibt. Für Wiederholungen werden keine Kosten berechnet.
Webhook-Zustellung
Abschnitt betitelt „Webhook-Zustellung“Übergeben Sie bei lang laufenden Scrapes webhook=<URL>, damit die Antwort per POST an Ihren Endpunkt gesendet wird, sobald sie fertig ist:
curl "https://scrape.shifter.io/v1?api_key=YOUR_API_KEY&url=https://example.com&webhook=https%3A%2F%2Fyour.app%2Fcallback"Sie zahlen weiterhin 1 Credit pro erfolgreicher Zustellung.
Überwachung
Abschnitt betitelt „Überwachung“Die Credit-Nutzung und Fehlerrate in Echtzeit sind im Panel unter Web Scraping API → Usage einsehbar.