Erreurs et limites
| Événement | Facturé ? |
|---|---|
| Requête réussie (HTTP 200) | 1 crédit |
Succès avec rendu activé (render_js=1) | 1 crédit |
| Requête échouée (délais d’attente, erreurs de connexion) | 0 crédit |
| HTTP 4xx ou 5xx provenant de la cible | 0 crédit |
| Nouvelles tentatives au sein d’un même appel | Comptées comme l’appel parent unique |
Vous n’êtes facturé que pour les réponses qui vous parviennent avec un statut 2xx et un corps non vide.
Concurrence
Section intitulée « Concurrence »| Forfait | Requêtes concurrentes maximales |
|---|---|
| Starter | 20 |
| Growth | 50 |
| Business | 100 |
| Enterprise | 500 |
Les requêtes dépassant le plafond renvoient 429 Too Many Requests. Patientez avec un délai exponentiel avant de réessayer.
Codes d’erreur
Section intitulée « Codes d’erreur »| Statut | Signification | Que faire |
|---|---|---|
200 | Succès, corps de réponse joint | Traiter normalement |
400 | Requête invalide (paramètres malformés) | Corriger le paramètre extract_rules ou url |
401 | api_key invalide ou manquante | Vérifier la clé dans le panneau |
403 | Le forfait ne permet pas cette fonctionnalité | Passer à un forfait supérieur ou retirer le paramètre (par ex. premium_proxy sur Starter) |
408 | Le site cible a dépassé le délai d’attente | Réessayer avec un timeout= plus élevé, ou des options plus simples |
422 | Échec du rendu (plantage JS, erreur de navigation) | Réessayer ; vérifier que le site fonctionne dans un vrai navigateur |
429 | Plafond de concurrence dépassé | Patienter puis réessayer |
500 | Erreur interne de Shifter | Réessayer après un court délai, ou contacter le support si le problème persiste |
509 | Crédits du forfait épuisés | Passer à un forfait supérieur ou attendre le prochain cycle de facturation |
Nouvelles tentatives automatiques
Section intitulée « Nouvelles tentatives automatiques »Les récupérations échouées, les CAPTCHAs et les erreurs 5xx transitoires provenant de la cible sont automatiquement retentées (jusqu’à 3 fois) avec des proxies différents avant que le point de terminaison ne renvoie une erreur. Ces nouvelles tentatives ne vous sont pas facturées.
Livraison par webhook
Section intitulée « Livraison par webhook »Pour les tâches de scraping longues, transmettez webhook=<URL> afin que la réponse soit envoyée par POST à votre point de terminaison une fois prête :
curl "https://scrape.shifter.io/v1?api_key=YOUR_API_KEY&url=https://example.com&webhook=https%3A%2F%2Fyour.app%2Fcallback"Vous payez toujours 1 crédit par livraison réussie.
Surveillance
Section intitulée « Surveillance »L’utilisation des crédits et le taux d’erreur en temps réel sont visibles dans le panneau sous Web Scraping API → Usage.