Dépannage
Échec des appels de vérification des backlinks dans votre assistant : un tableau des symptômes
Les assistants atténuent les erreurs. Cette page liste ce que vous voyez dans le chat, ce qui s'est produit en arrière-plan et la solution, en commençant par les symptômes les plus coûteux.
Équipe de recherche SEO AI Pal ·
Symptôme, cause, solution
| Ce que montre le chat | Ce qui s'est produit | Solution |
|---|---|---|
| "Impossible de récupérer les données" sans détail | Probablement HTTP 401. La clé est manquante, mal tapée ou collée avec un espace à la fin. | Recopiez la clé. Testez avec l'action gratuite overview dans un terminal. |
| Fonctionnait hier, "service indisponible" aujourd'hui | Probablement HTTP 402. Le solde est tombé à zéro après une boucle ou une longue session. | Rechargez avec USDT (TRC-20) depuis la page du compte. Les actions gratuites répondent toujours. |
| Une note de 0 ou aucune ligne pour un site réel | L'index ne contient peut-être pas encore le domaine, ou le nom a été envoyé avec un chemin ou https://. | Envoyez le domaine nu. Réessayez le mois prochain si le site est tout nouveau. |
| Le nouveau lien créé est manquant | L'index se rafraîchit environ une fois par mois. | Attendez le rafraîchissement. Ne relancez pas l'appel dix fois. |
| Les nombres diffèrent du tableau de bord d'un autre fournisseur | Des crawlers différents et des méthodes de calcul différentes. Notre DR est une métrique propre. | Comparez les tendances, pas les chiffres isolés. |
| La réponse liste beaucoup moins de lignes que prévu | Le schéma a limité per, ou l'assistant n'a lu que la première page. | Demandez explicitement page=2. |
La réponse contient des nombres mais pas _credits | Aucun appel n'a été effectué. Le modèle a répondu de mémoire. | Appliquez les règles du manuel d'exécution des invites. |
| Des frais plus élevés que prévu | L'assistant a réessayé une action payante ou a bouclé sur une liste. | Limitez les réessais à un seul et regroupez avec bulk_dr. |
Pourquoi le code de statut est plus important que le message
Un assistant transforme un 402 en un paragraphe poli. Vous lisez le paragraphe, pas le code. Demandez le statut brut. C'est le diagnostic le moins cher que vous ayez.
Séparez la faute en deux. Avant d'accuser le modèle, exécutez la même URL dans un terminal. Si curl renvoie un JSON avec ok true, l'API est fonctionnelle et la faute vient du wrapper ou de l'invite. Si curl échoue aussi, le problème vient de la clé ou du solde, et aucun libellé d'invite ne le corrigera.
Triage en quatre-vingt-dix secondes
- Exécutez l'appel défaillant avec curl et une action gratuite.
okest-il renvoyé ? - Exécutez-le avec une action payante. Un 401 pointe vers la clé, un 402 vers le solde.
- Imprimez le domaine exactement comme l'assistant l'a envoyé. Cherchez
www., les chemins et les guillemets. - Vérifiez la date de votre dernière commande par rapport au rafraîchissement mensuel.
- Lisez le journal des appels d'outils de votre produit assistant, pas son résumé.
Lorsqu'un script s'arrête en cours de route
Les scripts sont là où la facture augmente discrètement. Les trois cas ci-dessous montrent comment une interruption, une chaîne ou une erreur silencieuse se transforme en plus d'appels que prévu.
Un Ctrl-C peut laisser un lot à moitié terminé
De nombreux scripts bouclent sur une liste de domaines et effectuent un appel payant par élément. Appuyez sur Ctrl-C en cours de route. Les appels déjà effectués sont facturés, et les autres ne se produiront jamais. Votre fichier de sortie devrait indiquer quels domaines ont été traités.
Écrivez chaque résultat sur le disque dès qu'il arrive. Ainsi, un redémarrage peut sauter les domaines déjà traités au lieu de les payer deux fois.
Enchaîner des scripts multiplie les appels
Exécuter trois scripts et fusionner leurs résultats dans un seul email semble ordonné. Disons que chacun des trois scripts effectue deux appels payants, et une seule exécution facture six appels. Comptez d'abord, puis planifiez.
Un seul script qui collecte les données une fois, puis les formate, garde la facture et la logique à un seul endroit. Un script planifié devrait également afficher son nombre d'appels à la fin, afin que la prochaine vérification du solde ait un nombre à comparer.
Lisez le corps de l'erreur avant de relancer
Un appel échoué renvoie généralement toujours un corps avec ok à false et un message court. Lisez le message en premier. Une relance avec la même clé et le même solde échouera de la même manière.
Les scripts qui avalent le corps et n'impriment que le mot échec gaspillent l'indice unique que vous aviez. Citez le statut et le message tels qu'ils sont venus. Une paraphrase par l'assistant a déjà perdu le détail qui aurait aidé. Verbatim, toujours.
Erreurs et solutions dans le wrapper lui-même
Les mêmes trois erreurs apparaissent dans la plupart des wrappers. Mettre la clé dans l'URL signifie qu'elle apparaît dans les logs et les transcriptions partagées, donc utilisez l'en-tête bearer là où votre produit le permet.
Exposer toutes les actions est la deuxième erreur. Votre GPT n'a besoin que de quatre d'entre elles, et chaque action supplémentaire est une autre façon de dépenser des crédits que vous n'aviez pas prévus. La troisième est de demander 5 000 lignes alors qu'une réponse en utilise dix.
Corrigez-les une fois et la plupart du tableau ci-dessus ne s'appliquera plus. Les chiffres erronés qui survivent à tout cela sont couverts dans la page sur les mythes.
Mettez en place un journal d'appels qui affiche les échecs
Un journal est le diagnostic le moins cher que vous puissiez acheter. Il ne coûte rien à conserver, et il transforme une plainte vague sur le chat en une liste de codes de statut que vous pouvez compter. Deux habitudes suffisent.
Une ligne par appel, avec le statut
Écrivez l'horodatage, l'action, le domaine, le statut HTTP et la valeur _credits sur une seule ligne. Le texte brut suffit. Une feuille de calcul peut le lire plus tard, et une colonne de statuts montre un modèle qu'une seule réponse de chat masque.
Séparez les appels gratuits et payants dans des colonnes distinctes, afin qu'une augmentation des erreurs payantes ne se cache pas dans le total. Marquez tout appel qui a été réessayé, et gardez le nombre de réessais à côté de l'original. Des 402 répétés dans la même heure indiquent une boucle, pas une mauvaise journée. Lisez d'abord le journal. Accusez le modèle en dernier.
Alertez sur le statut, pas sur le ton
Une fenêtre de chat peut paraître calme tandis que le journal montre un 402 dans chaque ligne. Définissez une règle pour les codes de statut qui vous intéressent. Gardez-la sobre. Un 401 signifie la clé, un 402 le solde, et tout autre code signifie lire le corps.
Des actions gratuites qui répondent encore tandis que les payantes échouent sont un signal clair. Le solde est la cause probable. Le rechargement et le comptage des réessais viennent en premier. Les actions gratuites servent également de contrôle, car elles montrent que le chemin fonctionne toujours.
Reproduire un appel défaillant en cinq étapes
Travaillez de l'extérieur vers l'intérieur. Chaque étape élimine une couche, de sorte que la faute se retrouve à un seul endroit.
- 1
Copiez l'URL exacte
Prenez la requête envoyée par votre assistant ou script, octet par octet, y compris le domaine et son orthographe. Les espaces cachés et un
https://errant sont des coupables courants. - 2
Exécutez l'action gratuite overview
Envoyez le même domaine à
overview, qui ne nécessite pas de clé. Si cela répond avecoktrue, le chemin et le domaine sont corrects, et le problème vient de la clé ou du solde. - 3
Exécutez l'action payante avec la clé
Répétez l'appel payant avec la clé dans l'en-tête, comme le recommande la configuration du GPT personnalisé. Un 401 pointe vers la clé, et un 402 vers le solde.
- 4
Comparez la première ligne
Vérifiez que la première ligne renvoyée correspond au même appel effectué dans un terminal. Une incohérence signifie que le wrapper a modifié quelque chose en cours de route.
- 5
Notez le résultat
Conservez le statut, l'action, le domaine et la valeur
_creditsensemble. La prochaine personne à lire le journal saura ce qui s'est passé sans demander.
Distinguer un résultat vide réel d'un résultat cassé
Deux types de réponse se ressemblent dans une fenêtre de chat et signifient des choses très différentes. Distinguez-les d'abord. Modifier le mauvais élément coûte du temps et parfois des crédits.
Zéro ligne est une réponse
Un domaine peut revenir avec ok true et une liste vide. C'est une constatation sur l'index. Pas une faute dans l'appel. Cela peut être un site tout nouveau, une incohérence d'orthographe ou un lien qui n'a pas encore atteint le rafraîchissement mensuel.
Traitez-le comme un résultat. Signalez-le en une phrase. Gardez une courte liste de domaines qui sont revenus vides, avec la date de chaque appel. Si le même domaine reste vide pendant un mois, l'orthographe est le prochain suspect, et le rafraîchissement mensuel ne peut expliquer qu'une partie du problème.
Trop peu de lignes est un paramètre
Parfois, la réponse est courte parce que le schéma a limité les lignes, ou parce que le script n'a lu que la première page. Un appel est facturé une fois quel que soit le nombre de lignes, donc un per plus grand dans la demande ne coûte pas de crédit supplémentaire. Vérifiez d'abord la limite dans votre schéma. Commencez par là.
Demandez explicitement la page deux, et indiquez-le dans l'invite, plutôt que d'espérer que l'assistant remarque qu'il y a plus de données.
Réponses rapides
- Un outil de vérification des backlinks est-il le même qu'un tracker de position ?
- Non. Il lit les liens : domaines référents, ancres, pages principales et une note de 0 à 100. Les positions de mots-clés et les crawls quotidiens relèvent d'Ahrefs ou de Semrush, qui sont des produits plus complets pour ce travail. Utilisez chaque outil là où il est fort.
- Combien de lignes une seule appel peut-il renvoyer ?
- Jusqu'à 1 000 lignes par appel, avec
pageetper(10 à 5000) pour la pagination, et une pagination profonde limitée à 50 000. L'appel est facturé une fois quel que soit le nombre de lignes, donc unperplus grand ne coûte pas plus cher. - Pourquoi mon DR diffère-t-il de celui d'Ahrefs ?
- Notre note est round(100 log(ref_domains+1) / log(210^7)), une échelle logarithmique sur les domaines référents. Le DR d'Ahrefs est une métrique séparée avec sa propre méthode. Similaire dans l'esprit, jamais le même chiffre.
