Post: fel
Anrop för att kontrollera domänpoäng som misslyckas: 401, 402 och tomma rader
Post: fel. Två HTTP-koder bär en betydelse, en flagga berättar om ett anrop slutfördes, och en dataegenskap förklarar de flesta överraskningar.
Symtom, orsak, åtgärd
| Symtom | Trolig orsak | Åtgärd |
|---|---|---|
| HTTP 401 | Nyckel saknas, felaktigt skriven eller återkallad | Skicka key=sk_... eller Bearer-huvudet; kopiera nyckeln igen från kontosidan |
| HTTP 402 | Krediterna är slut | Ladda upp med USDT (TRC-20); gratisåtgärder fungerar fortfarande |
| ok är false | Anropet slutfördes inte | Läs HTTP-statusen först, sedan responsbodyn |
| Domänen verkar ha poänglöst | Få eller inga länkar i indexet | Titta på hänvisande domäner; DR på 0 betyder att inga hittades |
| Nylig länk saknas | Indexet uppdateras ungefär en gång i månaden | Vänta på nästa uppdatering; försök inte igen i en slinga |
| Sidor slutar efter 50 000 rader | Pagineringsgräns | Begränsa med en fråga eller sortering, paginera sedan igen |
| Bulk-anrop avvisat | Mer än 2 000 domäner | Dela upp listan i bitar |
Betalningar sker i USDT på TRC-20-nätverket. Inloggning är endast via Google. Bulklistor är begränsade till 2 000 domäner, listningsanrop till 1 000 rader, och djup paginering till 50 000 rader.
Diagnosordning
Börja med statuskoden. En 401 handlar om identitet och en 402 handlar om pengar. De åtgärdas på olika ställen.
Läs sedan ok. Varje respons innehåller den. Vid autentiserade anrop visar _credits kostnaden och det återstående saldot, så ett tömt saldo är synligt innan 402 dyker upp.
Behåll denna ordning fast i din runbook. Den som hoppar rakt in i datan kan spendera en hel förmiddag på ett problem som statuskoden hade identifierat direkt.
Misstänk först datan därefter. En ung webbplats visar ofta låg DR. Orsaken är sällan ett fel. Den troligare orsaken är en månatlig ögonblicksbild som är äldre än dess länkar. Jämför siffran med formelposten.
Att skilja på ett nyckelfel och ett saldosfel
En 401 och en 402 ser likadana ut i ett skript, eftersom de båda stoppar samma slinga. De har olika orsaker, så dela upp dem innan du ändrar något.
Börja med en gratisåtgärd på samma domän. Om den svarar och det betalda anropet inte gör det, är domänen okej och problemet ligger i nyckeln eller saldot.
När en 401 följer på en kopia
En nyckel som klistras in med ett mellanslag i slutet eller en avklippt ände är en vanlig orsak till en 401. Nycklar börjar med sk_, så kontrollera det prefixet och jämför hela strängen med kopian på kontosidan.
Ersätt nyckeln på ett ställe och kör samma enskilda anrop igen. Att ändra flera saker samtidigt gör resultatet svårt att läsa.
När en 402 dyker upp efter en påfyllning
En 402 betyder att den betalda åtgärden inte har någon kredit kvar. Läs det återstående saldot i _credits i nästa autentiserad respons innan något annat.
Om det saldot ser rätt ut, jämför det med kostnaden för det anrop som misslyckades. Siffrorna visar om anropet är helt enkelt större än saldot.
Spara en anteckning om tiden du laddade upp, så att loggen och saldot kan jämföras senare.
En kort anteckning om saldot före och efter varje påfyllning gör nästa 402 enklare att läsa.
Att gå igenom ett tomt resultat
Bekräfta att anropet slutfördes
Läs ok först. Ett false-värde betyder att anropet inte avslutades, så en tom lista säger inget om domänen.
Kontrollera namnet du skickade
q-värdet måste vara en bar domän. Ett schema, en sökväg eller ett vilseledande mellanslag kan ge ett tomt svar som ser ut som ett riktigt.
Jämför med en gratisåtgärd
Kör översikt på samma namn. Om det returnerar data och listningen inte gör det, är listningsåtgärden och dess gränser nästa misstänkte.
Kontrollera uppdateringsdatumet
Indexet uppdateras ungefär en gång i månaden. En länk som lagts till efter den senaste uppdateringen visas inte, hur många gånger du som anropar slutpunkten.
Minimal återförsökspolicy
- Försök inte igen automatiskt på en 401 eller 402
- Försök igen på nätverksfel med växande fördröjningar
- Stoppa när _credits visar ett saldo nära noll
- Cacha lyckade svar för månaden
- Logga åtgärden och domänen vid varje misslyckande
Kantfrågor
Dras krediter för ett misslyckat anrop?
Vi anger ingen faktureringsregel för misslyckade anrop i denna referens. Övervaka _credits i nästa autentiserad respons och jämför det återstående saldot med dina förväntningar.
Varför fungerar en gratisåtgärd efter en 402?
Eftersom domain, overview, stats och suggest inte behöver någon nyckel eller någon kredit. Endast betalda åtgärder blockeras när saldot är tomt.
Varifrån kommer fältnamn?
Se API-fältposten för den allmänna formen och anropa en live-slutpunkt för åtgärdspecifika rader.
Varför en poäng kan se fel ut utan något fel
Ibland anländer alla fält i tid och siffran överraskar dig ändå. Responsen är korrekt för sin ögonblicksbild, så den verkliga frågan är vad den ögonblicksbilden innehåller.
Tre situationer förklarar de flesta av dessa fall.
En nyligen lanserad domän
En webbplats som lanserats nyligen kan visa DR 0 eftersom ögonblicksbilden är äldre än dess länkar. Noll här betyder att ingen länkande domän hittades, inte en dom över webbplatsen.
Vänta på en senare uppdatering innan du läser siffran som en bedömning av webbplatsen.
Jämför domänens ålder med uppdateringscykeln innan du agerar. Ett nytt namn och ett gammalt namn som aldrig lockade till sig länkar ser likadana ut i samma ögonblicksbild.
En länk som kom till denna månad
Länkar som lagts till efter den senaste uppdateringen saknas i siffran. Ett upprepat anrop returnerar samma svar tills nästa uppdatering anländer.
Notera datumet för länken och datumet för ögonblicksbilden, så att gapet är lätt att förklara för vem som helst som läser rapporten.
En länk som försvann
En länk kan försvinna när dess sida raderas eller donatorns webbplats stänger. Antalet minskar då även om inget förändrades på din sida.
Jämför två ögonblicksbilder några månader innan du skyllar slutpunkten.
Räkna hur många domäner som flyttar sig, inte bara totalen. En liten förlust spridd över många webbplatser läser sig annorlunda än en stor förlust från en enda webbplats.
Var varje åtgärd finns
Att reproducera ett misslyckande för en buggrapport
Förenkla till ett anrop
Ta bort slingan och behåll ett enda curl-kommando som misslyckas.
Spara responsen
Notera HTTP-statusen, värdet på ok och _credits-fältet om det finns.
Prova en gratisåtgärd på samma domän
Om overview fungerar och den betalda åtgärden inte gör det, är felet nyckel eller saldot, inte domänen.
Skicka detaljerna
Notera tiden, åtgärden och de första och sista tecknen i nyckeln, så att anropet kan matchas till kontot. Behåll hela nyckeln borta från rapporten.
Vad man ska registrera vid varje misslyckat anrop
| Registrera | Varför det hjälper |
|---|---|
| HTTP-status | Separerar en 401 från en 402 på en glimt |
| ok-värdet | Visar om anropet slutfördes |
| _credits, när det finns | Visar saldot vid tidpunkten för misslyckandet |
| Åtgärd och domän | Låter dig upprepa samma anrop med avsikt |
| Tidpunkt för anropet | Placerar det mot den månatliga uppdateringen |
Varför inte auto-försök igen
Att loopa på en 402 bränner tid och ger ingenting. Att loopa på en 401 kan utlösa missbruksspaning hos vilken leverantör som helst, vår eller Googles.
Reservera försök igen för nätverksfel, och ge varje försök en längre paus än det föregående. Tre försök är en rimlig takgräns för ett nattjobb.
Säg att ett nattjobb möter en 402 klockan två på natten. Att försöka igen var femte minut till frukost ger ungefär hundra identiska misslyckanden, och var och en är en logglinje någon måste läsa senare.
Använd en fast takgräns för nätverksförsök igen också, och logga varje försök. En takgräns du kan ange på en mening är lätt att försvara när ett jobb stannar.
Varningar för ett jobb som körs utan tillsyn
Ett nattjobb för att kontrollera domänpoäng bör berätta för någon när det stannar, och det bör säga varför. De två koderna behöver olika varningar, så håll isär dem i meddelandet.
Varna vid första 401:an
En 401 betyder oftast ett nyckelfel, så ett enda misslyckande är värt ett meddelande. Att vänta på hundra identiska misslyckanden fördröjer bara åtgärden.
Inkludera de första och sista tecknen i nyckeln i varningen, inte hela nyckeln, så att meddelandet är säkert att dela med en kollega.
En 402 förtjänar sitt eget meddelande, eftersom dess botemedel är en påfyllning snarare än en ändring av nyckel.
Ett tyst jobb är inte nödvändigtvis ett friskt jobb. Räkna körningarna som avslutades, inte bara körningarna som misslyckades, och varna när ingen av dessa rörelser sker under en fullständig cykel.
Varna vid ett sjunkande saldot
Ställ varningsnivån på en nivå som täcker resten av körningen, inte vid noll. Ett saldot som är nästan tomt när jobbet startar lämnar inget utrymme för försök igen.
Läs nivån från _credits i varje autentiserad respons, så att varningen inte behöver någon extra begäran.
Vår crawler och vårt länkindex uppdateras ungefär en gång i månaden. En nyligen lanserad webbplats kan visa DR 0, och det är en korrekt läsning av ögonblicksbilden, eftersom den ännu inte innehåller någon länkande domän för webbplatsen.
