Problèmes fréquents
Résoudre les problèmes les plus courants avec HuntAPI.
La plupart des tickets se ramènent à une poignée de causes. Parcourez cette page d'abord : c'est généralement plus rapide que d'attendre une réponse.
| Symptôme | Cause probable | Correction |
|---|---|---|
Tous les appels renvoient 401 | Mauvais nom d'en-tête, ou espace copié avec le secret | L'en-tête est x-api-key. Recopiez le secret ou créez une nouvelle clé. |
401 Rate limit exceeded | Un quota par clé, ou la limite de débit de votre offre | Étalez le trafic, relevez les limites de la clé, ou passez à une offre supérieure. |
Les appels renvoient soudain 402 | Solde épuisé, ou facture impayée | Achetez une recharge, activez la recharge automatique, ou réglez la facture. |
| Dépassements de délai à exactement 10 s ou 30 s | Votre plateforme coupe avant notre réponse | Portez le délai de votre fonction ou de votre client à 60 secondes. |
400 sur une requête qui fonctionnait | Paramètre requis manquant ou mal orthographié | Comparez avec la page du point d'accès dans la Référence API. |
| Les crédits baissent plus vite que prévu | Nouvelles tentatives, ou boucle sur le même point d'accès | Cherchez des appels identiques répétés dans les journaux de requêtes. |
| Solde ou clés absents dans le tableau de bord | Mauvais espace de travail sélectionné | Utilisez le sélecteur en haut de la barre latérale. |
| Le Playground consomme des crédits de façon inattendue | Les appels du Playground sont de vrais appels API | Utilisez le point d'accès usage gratuit pour tester l'auth, ou le Simulateur pour estimer le coût sans trafic. |
402 alors que des crédits s'affichent encore | Une facture impayée bloque le compte | Ouvrez Paramètres → Factures, réglez la facture, puis réessayez. |
Checklist de 60 secondes
Lire le code de statut
401 → clé ou limite de débit. 402 → solde ou facture. 400 → paramètres. 5xx → réessayez avec un backoff.
Retrouver la ligne dans Journaux API
Faites correspondre l'horodatage. Ouvrez le panneau de détail pour les paramètres exacts et le message d'erreur.
Vérifier le solde dans la barre latérale
S'il est proche de zéro, rechargez ou activez la recharge automatique avant de relancer une charge de production.
Toujours bloqué
Ouvrez un ticket de support depuis Paramètres → Support → Nouveau ticket. Indiquez le point d'accès, l'horodatage et le code de statut observé : avec ces trois éléments, nous retrouvons la requête en quelques secondes. API Status, dans le même menu, vous dit si le problème vient de notre côté.