Réponse & codes d'erreur
En cas de succès, WyndPath renvoie le contenu brut de la cible avec son code HTTP d'origine, enrichi d'en-têtes de diagnostic. En cas d'erreur côté WyndPath, un JSON explicite.
En-têtes de diagnostic
Chaque réponse réussie porte des en-têtes X-WyndPath-* qui décrivent le trajet emprunté :
| En-tête | Contenu |
|---|---|
X-WyndPath-Credits | Crédits débités pour cette requête. |
X-WyndPath-Proxy-Type | Type d'IP utilisé (datacenter, residential…). |
X-WyndPath-Route | Voie empruntée (légère ou navigateur). |
X-WyndPath-Escalated | 1 si WyndPath a dû escalader vers une voie plus forte. |
X-WyndPath-Attempts | Nombre de tentatives internes effectuées. Elles ne sont pas facturées séparément (voir Crédits). |
X-WyndPath-Final-Status | Code HTTP renvoyé par la cible. |
Codes d'erreur
Les erreurs WyndPath sont renvoyées en JSON : {"error": "code", ...}.
| Statut | Code | Cause |
|---|---|---|
| 401 | invalid_api_key | Clé absente, invalide, désactivée ou compte bloqué. |
| 403 | domain_not_allowed | La cible n'est pas dans la liste autorisée de votre compte. |
| 403 | domain_blocked | Cible interdite globalement (usage illicite/abusif). |
| 403 | unsafe_target | URL non autorisée (adresse interne / non publique). |
| 413 | body_too_large | Corps de la requête POST trop volumineux. |
| 422 | invalid_url | Paramètre url manquant ou schéma non http(s). |
| 428 | profile_data_required | La cible exige des identifiants que votre compte n'a pas fournis. |
| 429 | too_many_concurrent | Limite de requêtes simultanées de votre forfait atteinte. |
| 429 | rate_limited | La cible limite le débit ; réessayez plus tard. |
| 502 | no_provider_available | Aucune voie disponible pour servir cette cible. |