Foutopsporing
Mislukte backlinktoolaanroepen in je assistant: een symptoomtabel
Assistants gluren fouten over heen. Deze pagina somt op wat je in de chat ziet, wat er onder het oppervlak gebeurde en de oplossing, beginnend met de symptomen die het meest kosten.
SEO AI Pal research team ·

Symptoom, oorzaak, oplossing
| Wat de chat toont | Wat er gebeurde | Oplossing |
|---|---|---|
| "Ik kon geen gegevens ophalen" zonder details | Waarschijnlijk HTTP 401. De sleutel ontbreekt, is verkeerd getypt of bevat een spatie aan het einde. | Plak de sleutel opnieuw. Test met de gratis overview-actie in een terminal. |
| Gisteren werkte het, vandaag "service unavailable" | Waarschijnlijk HTTP 402. Het saldo is nul geworden na een lus of een lange sessie. | Laad op met USDT (TRC-20) vanaf de accountpagina. Gratis acties blijven wel antwoorden. |
| Een rating van 0 of geen rijen voor een echte site | De index bevat het domein mogelijk nog niet, of de naam werd verzonden met een pad of https://. | Verstuur het domein zonder extra toevoegingen. Probeer het volgende maand opnieuw als de site nieuw is. |
| De nieuwe link die je hebt gebouwd ontbreekt | De index wordt ongeveer één keer per maand ververst. | Wacht op de verversing. Voer de aanroep niet tien keer achter elkaar uit. |
| Cijfers verschillen van het dashboard van een andere leverancier | Verschillende crawlers en verschillende scoremethoden. Onze DR is een eigen metric. | Vergelijk trends, geen losse cijfers. |
| De reply bevat veel minder rijen dan verwacht | Het schema beperkte per, of de assistant las alleen pagina één. | Vraag expliciet om page=2. |
De reply bevat cijfers maar geen _credits | Er is geen aanroek gedaan. Het model antwoordde vanuit geheugen. | Pas de regels toe in de prompt runbook. |
| Kosten hoger dan gepland | De assistant herhaalde een betaalde actie of liep in een lus over een lijst. | Beperk herhaalde pogingen tot één en voer uit in batches met bulk_dr. |
Waarom de statuscode belangrijker is dan de zin
Een assistant verandert een 402 in een beleefde paragraaf. Je leest de paragraaf, niet de code. Vraag om de ruwe status. Dit is de goedkoopste diagnose die je hebt.
Splits de fout in tweeën. Voordat je het model de schuld geeft, voer dezelfde URL uit in een terminal. Als curl JSON retourneert met ok true, is de API in orde en zit de fout in de wrapper of het prompt. Als curl ook faalt, zijn de sleutel of het saldo het probleem, en zal geen enkele formulering van het prompt dit oplossen.
Negenentwintig seconden triage
- Voer de mislukte aanroek uit met curl en een gratis actie. Komt
okterug? - Voer het uit met een betaalde actie. Een 401 wijst naar de sleutel, een 402 naar het saldo.
- Print het domein exact zoals de assistant het verzond. Kijk naar
www., paden en aanhalingstekens. - Controleer de datum van je laatste bestelling tegen de maandelijkse verversing.
- Lees het toolaanroeklogboek van je assistantproduct, niet de samenvatting.

Wanneer een script halverwege stopt
Scripts zijn waar de rekening stil groeit. De drie gevallen hieronder tonen hoe een stop, een ketting of een stille fout leidt tot meer aanroepen dan gepland.
Een Ctrl-C kan een batch halveer achterlaten
Veel scripts loopen over een lijst van domeinen en maken één betaalde aanroek per item. Druk op Ctrl-C halverwege. De reeds uitgevoerde aanroepen worden gefactureerd, de rest gebeurt niet. Je uitvoerbestand moet aangeven welke domeinen klaar zijn.
Schrijf elk resultaat direct weg naar schijf. Dan kan een herstart de reeds afgeronde domeinen overslaan in plaats van ze twee keer te betalen.
Het chainen van scripts vermenigvuldigt de aanroepen
Drie scripts draaien en hun output samenvoegen in één e-mail klinkt netjes. Stel dat elk van de drie scripts twee betaalde aanroepen doet, dan kost één run zes aanroepen. Tel eerst, plan dan.
Eén script dat de data één keer verzamelt en deze daarna opmaakt, houdt de rekening en de logica op één plek. Een gepland script moet ook het aantal aanroepen aan het einde printen, zodat je bij de volgende controle van het saldo een getal hebt om mee te vergelijken.
Lees de foutbody voordat je opnieuw probeert
Een mislukte aanroep retourneert meestal nog steeds een body met ok ingesteld op false en een korte boodschap. Lees de boodschap eerst. Een herhaling met dezelfde sleutel en hetzelfde saldo faalt op dezelfde manier.
Scripts die de body slikken en alleen het woord 'failed' printen, verspillen de enige aanwijzing die je had. Citeer de status en boodschap zoals ze kwamen. Een parafrase door de assistant is de details al kwijt die geholpen hadden. Woordelijk, altijd.
Fouten en oplossingen in de wrapper zelf
Dezelfde drie fouten komen in de meeste wrappers terug. De sleutel in de URL zetten betekent dat deze in logs en gedeelde transcripten verschijnt, dus gebruik de bearer header waar je product dit toelaat.
Elke actie blootstellen is de tweede. Je GPT heeft er maar vier nodig, en elke extra actie is een manier om krediet uit te geven dat je niet had gepland. De derde is het aanvragen van 5.000 rijen terwijl de reply er tien gebruikt.
Los ze één keer op en de meeste van de bovenstaande tabel is niet meer van toepassing. Verkeerde cijfers die na al dit alles overblijven, worden behandeld op de myths pagina.

Stel een aanroeklogboek in dat fouten toont
Een logboek is de goedkoopste diagnose die je ooit zult kopen. Het kost niets om bij te houden, en het verandert een vaag klachtje over de chat in een lijst van statuscodes die je kunt tellen. Twee gewoontes zijn genoeg.
Eén regel per aanroek, met de status
Schrijf de tijdstip, de actie, het domein, de HTTP-status en de _credits waarde op één regel. Platte tekst is genoeg. Een spreadsheet kan dit later lezen, en een kolom met statussen toont een patroon dat een enkele chatreply verbergt.
Houd gratis en betaalde aanroepen in aparte kolommen, zodat een stijging in betaalde fouten niet in het totaal verstopt raakt. Markeer elke aanroep die is herhaald, en houd het aantal herhalingen naast de originele. Herhaalde 402'en in hetzelfde uur wijzen op een lus, niet op een slechte dag. Lees eerst het logboek. Geef het model pas de schuld.
Geef een alarm op de status, niet op de toon
Een chatvenster kan kalm lijken terwijl het logboek een 402 in elke rij toont. Stel een regel in voor de statuscodes die je interessant vindt. Houd het saai. Een 401 betekent de sleutel, een 402 betekent het saldo, en alles anders betekent de body lezen.
Gratis antwoorden terwijl betaalde falen is een duidelijk signaal. Saldo is de waarschijnlijke oorzaak. Opwaarderen en het aantal herhalingen tellen komen eerst. Gratis acties dienen ook als controle, omdat ze aangeven dat het pad zelf nog werkt.
Reproduceer een mislukte aanroek in vijf stappen
Werk van buiten naar binnen. Elke stap sluit één laag uit, zodat de fout op één plek eindigt.
- 1
Kopieer de exacte URL
Neem het verzoek dat je assistant of script stuurde, byte voor byte, inclusief het domein en de spelling. Verborgen spaties en een losse
https://zijn veelvoorkomende boosdoeners. - 2
Voer de gratis overview-actie uit
Verstuur hetzelfde domein naar
overview, wat geen sleutel nodig heeft. Als dat antwoordt metoktrue, zijn het pad en het domein in orde, en zit het probleem bij de sleutel of het saldo. - 3
Voer de betaalde actie uit met de sleutel
Herhaal de betaalde aanroep met de sleutel in de header, zoals de custom GPT setup aanbeveelt. Een 401 wijst naar de sleutel, en een 402 naar het saldo.
- 4
Vergelijk de eerste rij
Controleer of de eerste geretourneerde rij overeenkomt met dezelfde aanroep die in een terminal is gemaakt. Een mismatch betekent dat de wrapper iets heeft veranderd onderweg.
- 5
Schrijf het resultaat op
Houd de status, de actie, het domein en de
_creditswaarde bij elkaar. De volgende persoon die het logboek leest, weet wat er gebeurde zonder te hoeven vragen.
Een echt lege resultaat onderscheiden van een kapotte
Twee soorten antwoorden lijken op elkaar in een chatvenster en betekenen heel verschillend. Maak ze eerst uit elkaar. Het verkeerde ding veranderen kost tijd en soms credits.
Nul rijen is een antwoord
Een domein kan terugkomen met ok true en een lege lijst. Dat is een bevinding over de index. Geen fout in de aanroep. Het kan een nieuwe site zijn, een spellingverschil of een link die nog niet de maandelijkse verversing heeft bereikt.
Behandel het als een resultaat. Rapporteer het in één zin. Houd een korte lijst bij van domeinen die leeg terugkwamen, met de datum van elke aanroep. Als hetzelfde domein een maand leeg blijft, is de spelling de volgende verdachte, en de maandelijkse verversing kan niet alles verklaren.
Te weinig rijen is een instelling
Soms is de reply kort omdat het schema de rijen beperkte, of omdat het script alleen pagina één las. Een aanroep wordt één keer gefactureerd, ongeacht het aantal rijen, dus een grotere per in het verzoek kost geen extra krediet. Controleer eerst de cap in je schema. Begin daar.
Vraag expliciet om pagina twee, en zeg dit in het prompt, in plaats van te hopen dat de assistant merkt dat er meer is.
Snelle antwoorden
- Is een check backlink tool hetzelfde als een rank tracker?
- Nee. Het leest links: verwijzende domeinen, anchors, top pagina's en een 0-100 rating. Trefwoordposities en dagelijkse crawls behoren tot Ahrefs of Semrush, die vollere producten zijn voor die taak. Gebruik elk waar het sterk is.
- Hoeveel rijen kan één aanroep retourneren?
- Tot 1.000 rijen per aanroep, met
pageenper(10 tot 5000) voor paginering, en diepe paginering beperkt tot 50.000. De aanroep wordt één keer gefactureerd, ongeacht het aantal rijen, dus een grotereperkost niet meer. - Waarom verschilt mijn DR van Ahrefs?
- Onze rating is round(100 log(ref_domains+1) / log(210^7)), een logaritmische schaal op verwijzende domeinen. Ahrefs DR is een aparte metric met een eigen methode. Vergelijkbaar van aard, nooit hetzelfde getal.