Felsökning
Misslyckade backlink-anrop i din assistent: en symtomtabell
Assistenter släpar över fel. Denna sida listar vad du ser i chatten, vad som hände under ytan och lösningen, börjande med de symtom som kostar mest.
SEO AI Pals forskningsgrupp ·

Symtom, orsak, lösning
| Vad chatten visar | Vad som hände | Lösning |
|---|---|---|
| "Kunde inte hämta data" utan detaljer | Sannolikt HTTP 401. Nyckeln saknas, är felstavad eller klistrades in med ett mellanslag i slutet. | Klistra in nyckeln igen. Testa med den fria overview-åtgärden i en terminal. |
| Fungerade igår, "service unavailable" idag | Sannolikt HTTP 402. Saldo nådde noll efter en slinga eller en lång session. | Ladda upp med USDT (TRC-20) från kontosidan. Gratisåtgärder svarar fortfarande. |
| En betyg på 0 eller inga rader för en riktig webbplats | Indexet innehåller kanske inte domänen än, eller så skickades namnet med en sökväg eller https://. | Skicka bara domänen. Försök igen nästa månad om webbplatsen är helt ny. |
| Den nya länk du skapade saknas | Indexet uppdateras ungefär en gång i månaden. | Vänta på uppdateringen. Kör inte anropet tio gånger i rad. |
| Siffrorna skiljer sig från en annan leverantörs dashboard | Olika crawlers och olika bedömning. Vårt DR är en egen metric. | Jämför trender, inte enskilda siffror. |
| Svaret listar färre rader än förväntat | Schemat begränsade per, eller så läste assistenten bara sida ett. | Be explicit om page=2. |
Svaret har siffror men inga _credits | Inget anrop gjordes. Modellen svarade från minnet. | Tillämpa reglerna i prompt-runboken. |
| Avgifter högre än du planerade | Assistenten försökte om en betald åtgärd, eller slingade över en lista. | Begränsa omförsök till ett och kör i batch med bulk_dr. |
Varför statuskoden är viktigare än meningen
En assistent förvandlar en 402 till en artig paragraf. Du läser paragrafen, inte koden. Be om den råa statusen. Det är den billigaste diagnos du har.
Del upp felet i två. Innan du skyller på modellen, kör samma URL i en terminal. Om curl returnerar JSON med ok true, är API:et okej och felet ligger i omslaget eller prompten. Om curl också misslyckas är nyckeln eller saldot problemet, och ingen prompttext kommer att fixa det.
Nittio sekunder av triage
- Kör det misslyckade anropet med curl och en gratisåtgärd. Kommer
oktillbaka? - Kör det med en betald åtgärd. En 401 pekar på nyckeln, en 402 på saldot.
- Skriv ut domänen exakt som assistenten skickade den. Titta efter
www., sökvägar och citattecken. - Kontrollera datumet för din senaste order mot den månatliga uppdateringen.
- Läs verktygsanropsloggen för ditt assistentprodukt, inte dess sammanfattning.

När ett skript stannar mitt i
Skript är där fakturan växer tyst. De tre fallen nedan visar hur ett stopp, en kedja eller ett tyst fel blir fler anrop än du planerat.
En Ctrl-C kan lämna en batch halvfärdig
Många skript loopar över en lista med domäner och gör ett betalt anrop per objekt. Tryck Ctrl-C mitt i. Anropen som redan körts faktureras, och resten sker aldrig. Din outputfil bör ange vilka domäner som blev klara.
Skriv varje resultat till disk så snart det anländer. Då kan en omstart hoppa över domäner som redan är klara istället för att betala för dem två gånger.
Kedjor av skript multiplicerar anropen
Att köra tre skript och slå ihop deras output till ett enda e-postmeddelande låter snyggt. Säg att varje av de tre skripten gör två betalda anrop, och en enskild körning fakturerar sex. Räkna först, schemalägg sedan.
Ett enda skript som samlar in data en gång, och sedan formaterar det, håller fakturan och logiken på ett ställe. Ett schemalagt skript bör också skriva ut sitt anropantal i slutet, så att nästa gång du tittar på saldot har du ett nummer att matcha.
Läs felmeddelandet innan du kör om
Ett misslyckat anrop returnerar oftast fortfarande en body med ok satt till false och ett kort meddelande. Läs meddelandet först. Ett omkörning med samma nyckel och samma saldo misslyckas på samma sätt.
Skript som sväljer bodyn och bara skriver ut ordet failed slösar bort den ledtråd du hade. Citatera status och meddelande exakt som de kom. En paraphras av assistenten har redan förlorat detaljen som hade hjälpt. Verbatim, alltid.
Misstag och lösningar i själva omslaget
De samma tre misstagen dyker upp i de flesta omslag. Att ha nyckeln i URL:en betyder att den syns i loggar och i delade transkript, så använd bearer-header där din produkt tillåter det.
Att exponera varje åtgärd är det andra. Din GPT behöver bara fyra av dem, och varje extra åtgärd är ett sätt att spendera kredit du inte planerade på. Det tredje är att be om 5 000 rader när ett svar använder tio.
Fixa dem en gång och de flesta av tabellen ovan slutar gälla. Felaktiga siffror som överlever allt detta täcks på myt-sidan.

Skapa en anropslogg som visar misslyckanden
En logg är den billigaste diagnosen du någonsin köper. Den kostar inget att behålla, och den förvandlar ett vagt klagomål om chatten till en lista över statuskoder du kan räkna. Två vanor räcker.
En rad per anrop, med status
Skriv tidsstämpel, åtgärd, domän, HTTP-status och _credits-värdet på en rad. Plain text räcker. En kalkylblad kan läsa det senare, och en kolumn med statusar visar ett mönster som ett enskilt chatssvar döljer.
Håll gratis- och betalda anrop i separata kolumner, så att en ökning av betalda fel inte döljs i totalen. Märk alla anrop som försöktes om, och behåll omförsöksantalet bredvid originalet. Upprepade 402:or under samma timme pekar på en slinga, inte på en dålig dag. Läs loggen först. Skylla på modellen sist.
Varna på status, inte på tonen
Ett chattfönster kan se lugnt ut medan loggen visar en 402 i varje rad. Ställ in en regel för de statuskoder du bryr dig om. Håll det tråkigt. En 401 betyder nyckeln, en 402 betyder saldot, och något annat betyder att läsa bodyn.
Att gratisåtgärder fortfarande svarar medan betalda misslyckas är en tydlig signal. Saldot är den sannolika orsaken. Ladda upp och kontrollera omförsöksantalet först. Gratisåtgärder fungerar också som en kontroll, eftersom de visar att sökvägen fortfarande fungerar.
Reproducera ett misslyckat anrop i fem steg
Arbeta utifrån och in. Varje steg utesluter ett lager, så felet hamnar på ett ställe.
- 1
Kopiera exakt URL:en
Ta begäran som din assistent eller skript skickade, byte för byte, inklusive domänen och dess stavning. Dolda mellanslag och en vilseledande
https://är vanliga skyldiga. - 2
Kör den gratis overview-åtgärden
Skicka samma domän till
overview, som inte kräver någon nyckel. Om det svarar medoktrue är sökvägen och domänen okej, och problemet ligger hos nyckeln eller saldot. - 3
Kör den betalda åtgärden med nyckeln
Upprepa det betalda anropet med nyckeln i header, enligt vad inställningen för custom GPT rekommenderar. En 401 pekar på nyckeln, och en 402 pekar på saldot.
- 4
Jämför den första raden
Kontrollera att den första returnerade raden matchar samma anrop som gjordes i en terminal. En mismatch betyder att omslaget ändrade något på vägen.
- 5
Skriv ner resultatet
Behåll status, åtgärd, domän och
_credits-värdet tillsammans. Nästa person som läser loggen kommer att veta vad som hände utan att behöva fråga.
Att skilja på ett verkligt tomt resultat från ett trasigt
Två sorters svar ser lika ut i ett chattfönster och betyder mycket olika saker. Skilj på dem först. Att ändra fel sakning kostar tid och ibland krediter.
Noll rader är ett svar
En domän kan komma tillbaka med ok true och en tom lista. Det är en fyndning om indexet. Inte ett fel i anropet. Det kan vara en helt ny webbplats, en stavningsskillnad eller en länk som inte har nått den månatliga uppdateringen än.
Behandla det som ett resultat. Rapportera det i en mening. Behåll en kort lista över domäner som kom tillbaka tomma, med datumet för varje anrop. Om samma domän förblir tom i en månad är stavningen nästa misstänkte, och den månatliga uppdateringen kan bara förklara så mycket.
För få rader är en inställning
Ibland är svaret kort eftersom schemat begränsade raderna, eller eftersom skriptet bara läste sida ett. Ett anrop faktureras en gång oavsett antal rader, så en större per i begäran kostar ingen extra kredit. Kontrollera cap:et i ditt schema först. Börja där.
Be om sida två medvetet, och säg det i prompten, istället för att hoppas att assistenten märker att det finns mer.
Snabbsvar
- Är ett backlink-kontrollverktyg detsamma som en ranktracker?
- Nej. Det läser länkar: hänvisande domäner, ankor, toppsidor och ett betyg 0-100. Nyckelordspositioner och dagliga crawls tillhör Ahrefs eller Semrush, som är mer fullständiga produkter för det jobbet. Använd var och en där den är stark.
- Hur många rader kan ett anrop returnera?
- Upp till 1 000 rader per anrop, med
pageochper(10 till 5000) för paginering, och djup paginering begränsad till 50 000. Anropet faktureras en gång oavsett antal rader, så en störreperkostar inte mer. - Varför skiljer sig mitt DR från Ahrefs?
- Vårt betyg är round(100 log(ref_domains+1) / log(210^7)), en logaritmisk skala på hänvisande domäner. Ahrefs DR är en separat metric med sin egen metod. Liknande i anda, men aldrig samma siffra.