Entrée : erreurs
Appels de vérification du score de domaine qui échouent : 401, 402 et lignes vides
Entrée : erreurs. Deux codes HTTP ont un sens, un indicateur vous informe si l'appel est terminé, et une propriété de données explique la plupart des surprises.
Symptôme, cause, solution
| Symptôme | Cause probable | Solution |
|---|---|---|
| HTTP 401 | Clé manquante, mal tapée ou révoquée | Envoyez key=sk_... ou l'en-tête Bearer ; copiez à nouveau la clé depuis la page de compte |
| HTTP 402 | Les crédits sont épuisés | Rechargez en USDT (TRC-20) ; les actions gratuites continuent de fonctionner |
| ok est faux | L'appel n'est pas terminé | Lisez d'abord le statut HTTP, puis le corps de la réponse |
| Le domaine semble non score | Peu ou pas de liens dans l'index | Consultez les domaines référents ; un DR de 0 signifie qu'aucun n'a été trouvé |
| Lien récent manquant | Les actualisations de l'index ont lieu environ une fois par mois | Attendez la prochaine actualisation ; ne réessayez pas en boucle |
| Les pages s'arrêtent à 50 000 lignes | Limite de pagination | Affinez avec une requête ou un tri, puis paginez à nouveau |
| Appel en masse rejeté | Plus de 2 000 domaines | Divisez la liste en lots |
Les paiements sont effectués en USDT sur le réseau TRC-20. La connexion se fait uniquement via Google. Les listes en masse sont limitées à 2 000 domaines, les appels de liste à 1 000 lignes et la pagination profonde à 50 000 lignes.
Ordre du diagnostic
Commencez par le code de statut. Un 401 concerne l'identité et un 402 concerne l'argent. Ils se résolvent à des endroits différents.
Lisez ensuite ok. Chaque réponse le contient. Pour les appels authentifiés, _credits indique le coût et le solde restant, de sorte qu'un solde épuisé est visible avant l'arrivée du 402.
Conservez cet ordre fixe dans votre manuel d'exécution. Quiconque saute directement aux données peut passer une matinée sur un problème que le code de statut aurait nommé immédiatement.
Ce n'est qu'après cela que vous devriez soupçonner les données. Un site jeune affiche souvent un DR faible. La cause est rarement un bug. La raison plus probable est un instantané mensuel qui précède ses liens. Comparez le chiffre avec la entrée sur la formule.
Séparer un problème de clé d'un problème de solde
Un 401 et un 402 se ressemblent dans un script, car ils arrêtent la même boucle. Ils ont des causes différentes, donc séparez-les avant de modifier quoi que ce soit.
Commencez par une action gratuite sur le même domaine. Si elle répond et que l'appel payant ne le fait pas, le domaine est correct et le problème réside dans la clé ou le solde.
Lorsqu'un 401 suit une copie
Une clé collée avec un espace en fin de chaîne ou une extrémité coupée est une cause fréquente d'un 401. Les clés commencent par sk_, vérifiez donc ce préfixe et comparez la chaîne entière avec la copie sur la page de compte.
Remplacez la clé à un seul endroit et relancez le même appel unique. Modifier plusieurs choses en même temps rend le résultat impossible à lire.
Lorsqu'un 402 apparaît après une recharge
Un 402 signifie que l'action payante n'a plus de crédit. Lisez le solde restant dans _credits sur la prochaine réponse authentifiée avant toute autre chose.
Si ce solde semble correct, comparez-le avec le coût de l'appel qui a échoué. Les chiffres indiqueront si l'appel est simplement plus élevé que le solde.
Notez l'heure de votre recharge, afin que le journal et le solde puissent être comparés plus tard.
Une courte note du solde avant et après chaque recharge facilite la lecture du prochain 402.
Traitement d'un résultat vide
Confirmez que l'appel est terminé
Lisez ok en premier. Une valeur fausse signifie que l'appel n'est pas terminé, donc une liste vide ne vous apprend rien sur le domaine.
Vérifiez le nom envoyé
La valeur q doit être un domaine nu. Un schéma, un chemin ou un espace parasite peut produire une réponse vide qui ressemble à une réponse réelle.
Comparez avec une action gratuite
Exécutez overview sur le même nom. Si cela retourne des données et que la liste non, l'action de liste et ses limites sont les prochaines suspectes.
Vérifiez la date d'actualisation
L'index est mis à jour environ une fois par mois. Un lien ajouté après la dernière actualisation n'apparaîtra pas, aussi nombreuses que soient les appels à l'endpoint.
Politique de réessai minimale
- Ne réessayez jamais automatiquement un 401 ou un 402
- Réessayez les erreurs réseau avec des délais croissants
- Arrêtez lorsque _credits affiche un solde proche de zéro
- Mettez en cache les réponses réussies pour le mois
- Journalisez l'action et le domaine avec chaque échec
Questions marginales
Les crédits sont-ils déduits pour un appel échoué ?
Nous n'énonçons pas de règle de facturation pour les appels échoués dans cette référence. Surveillez _credits sur la prochaine réponse authentifiée et comparez le solde restant avec votre attente.
Pourquoi une action gratuite fonctionne-t-elle après un 402 ?
Parce que domain, overview, stats et suggest n'ont pas besoin de clé ni de crédit. Seules les actions payantes sont bloquées une fois le solde vide.
D'où viennent les noms de champs ?
Consultez l'entrée sur les champs de l'API pour la forme générale et appelez un endpoint en direct pour les lignes spécifiques à l'action.
Pourquoi un score peut sembler incorrect sans aucune erreur
Parfois, tous les champs arrivent à temps et le nombre vous surprend tout de même. La réponse est correcte pour son instantané, donc la vraie question est ce que cet instantané contient.
Trois situations expliquent la plupart de ces cas.
Un domaine lancé récemment
Un site lancé récemment peut afficher un DR 0 car l'instantané précède ses liens. Zéro ici signifie qu'aucun domaine référent n'a été trouvé, pas un verdict sur le site.
Attendez une actualisation ultérieure avant de lire le chiffre comme un jugement du site.
Comparez l'âge du domaine avec le cycle d'actualisation avant d'agir. Un nouveau nom et un ancien nom qui n'ont jamais attiré de liens se ressemblent dans le même instantané.
Un lien arrivé ce mois-ci
Les liens ajoutés après la dernière actualisation manquent au chiffre. Un appel répété retourne la même réponse jusqu'à ce que la prochaine actualisation arrive.
Notez la date du lien et la date de l'instantané, afin que l'écart soit facile à expliquer à quiconque lit le rapport.
Un lien disparu
Un lien peut disparaître lorsque sa page est supprimée ou que le site donateur ferme. Le compte diminue alors bien que rien n'ait changé de votre côté.
Comparez deux instantanés séparés de quelques mois avant de blâmer l'endpoint.
Comptez combien de domaines bougent, pas seulement le total. Une petite perte répartie sur de nombreux sites se lit différemment d'une grande perte provenant d'un seul site.
Où se trouve chaque solution
| Solution | Emplacement |
|---|---|
| Nouvelle ou clé copiée | Page de compte |
| Recharge en USDT (TRC-20) | Page de compte |
| Découpage et réessai | Votre propre code client |
| Attendre une actualisation | Rien à faire ; l'index est mis à jour environ une fois par mois |
Reproduire un échec pour un rapport de bug
Réduire à un appel
Supprimez la boucle et conservez une seule commande curl qui échoue.
Enregistrez la réponse
Notez le statut HTTP, la valeur de ok et le champ _credits s'il est présent.
Essayez une action gratuite sur le même domaine
Si overview fonctionne et que l'action payante ne le fait pas, la faute est la clé ou le solde, pas le domaine.
Envoyez les détails
Notez l'heure, l'action et les premier et dernier caractères de la clé, afin que l'appel puisse être associé au compte. Gardez la clé complète hors du rapport.
Que enregistrer avec chaque appel échoué
| Enregistrer | Pourquoi cela aide |
|---|---|
| Statut HTTP | Sépare un 401 d'un 402 d'un coup d'œil |
| La valeur ok | Montre si l'appel est terminé |
| _credits, lorsqu'il est présent | Montre le solde au moment de l'échec |
| Action et domaine | Vous permet de répéter le même appel intentionnellement |
| Heure de l'appel | Le place par rapport à l'actualisation mensuelle |
Pourquoi pas de réessai automatique
Boucler sur un 402 consume du temps et ne rapporte rien. Boucler sur un 401 peut déclencher la détection d'abus chez n'importe quel fournisseur, le nôtre ou celui de Google.
Réservez les réessais pour les erreurs réseau, et accordez à chaque réessai une pause plus longue que la précédente. Trois tentatives sont un plafond raisonnable pour un travail nocturne.
Imaginez qu'un travail nocturne rencontre un 402 à deux heures du matin. Réessayer toutes les cinq minutes jusqu'au petit-déjeuner produit environ cent échecs identiques, et chacun est une ligne de journal que quelqu'un devra lire plus tard.
Utilisez un plafond fixe pour les réessaux réseau également, et journalisez chaque tentative. Un plafond que vous pouvez énoncer en une phrase est facile à défendre lorsqu'un travail s'arrête.
Alertes pour un travail exécuté sans surveillance
Un travail nocturne de vérification du score de domaine devrait informer quelqu'un lorsqu'il s'arrête, et il devrait dire pourquoi. Les deux codes nécessitent des alertes différentes, donc gardez-les séparés dans le message.
Alerte sur le premier 401
Un seul 401 signifie généralement un problème de clé, donc un seul échec mérite un message. Attendre cent échecs identiques retarde seulement la solution.
Incluez les premier et dernier caractères de la clé dans l'alerte, pas la clé entière, afin que le message soit sûr à partager avec un collègue.
Un 402 mérite son propre message, car sa remède est une recharge plutôt qu'un changement de clé.
Un travail silencieux n'est pas nécessairement un travail sain. Comptez les exécutions qui ont terminé, pas seulement celles qui ont échoué, et alertez lorsque ni l'un ni l'autre compte ne bouge pour un cycle complet.
Alerte sur un solde en baisse
Définissez l'avertissement à un niveau qui couvre la fin de l'exécution, pas à zéro. Un solde presque vide au démarrage du travail ne laisse aucune marge pour les réessais.
Lisez le niveau depuis _credits sur chaque réponse authentifiée, afin que l'avertissement n'ait pas besoin d'une requête supplémentaire.
Notre crawler et notre index de liens sont actualisés environ une fois par mois. Un site récemment lancé peut afficher un DR 0, et c'est une lecture correcte de l'instantané, car il ne contient encore aucun domaine référent pour le site.
