Intrare: erori
Apeluri de verificare a scorului domeniului care eșuează: 401, 402 și rânduri goale
Intrare: erori. Două coduri HTTP au un sens, un indicator vă spune dacă un apel s-a finalizat, iar o proprietate de date explică majoritatea surprizelor.

Simptom, cauză, remediu
| Simptom | Cauză probabilă | Remediu |
|---|---|---|
| HTTP 401 | Cheie lipsă, tastată greșit sau revocată | Trimiteți key=sk_... sau header-ul Bearer; copiați din nou cheia din pagina de cont |
| HTTP 402 | Creditul s-a epuizat | Reîncărcați în USDT (TRC-20); acțiunile gratuite funcționează încă |
| ok este false | Apelul nu s-a finalizat | Citiți mai întâi statusul HTTP, apoi corpul răspunsului |
| Domeniul pare nescorat | Puține sau zero linkuri în index | Verificați domeniile care fac referire; DR de 0 înseamnă că nu a fost găsit niciunul |
| Link recent lipsă | Indexul se reîmprospătează aproximativ lunar | Așteptați următoarea reîmprospătare; nu repetați apelul în buclă |
| Paginarea se oprește la 50.000 de rânduri | Limita de paginare | Restrângeți cu un query sau sortare, apoi continuați paginarea |
| Apel în bloc respins | Mai mult de 2.000 de domenii | Împărțiți lista în bucăți |
Plățile sunt în USDT pe rețeaua TRC-20. Autentificarea este doar prin Google. Listele în bloc sunt limitate la 2.000 de domenii, apelurile de listare la 1.000 de rânduri, iar paginarea profundă la 50.000 de rânduri.
Ordinea diagnosticării
Începeți cu codul de status. Un 401 se referă la identitate, iar un 402 la bani. Ele se rezolvă în locuri diferite.
Apoi citiți ok. Fiecare răspuns îl conține. La apelurile autentificate, _credits arată costul și soldul rămas, astfel încât un sold epuizat este vizibil înainte de apariția 402.
Păstrați acest ordin fix în manualul dvs. de execuție. Orice cineva care sare direct la date poate petrece o dimineață pe o problemă pe care codul de status ar fi identificat-o imediat.
Doar după aceea ar trebui să bănuieți datele. Un site nou poate afișa un DR scăzut. Cauza este rar un bug. Motivul mai probabil este o instantanee lunară care precede linkurile sale. Comparați cifra cu intrarea despre formulă.
Separarea unei probleme de cheie de o problemă de sold
Un 401 și un 402 arată similar într-un script, deoarece ambele opresc aceeași buclă. Au cauze diferite, așa că separați-le înainte de a modifica ceva.
Începeți cu o acțiune gratuită pe același domeniu. Dacă aceasta răspunde, iar apelul plătit nu, domeniul este ok, iar problema este la cheie sau sold.
Când un 401 urmează unei copieri
O cheie lipită cu un spațiu la final sau tăiată este o cauză comună a unui 401. Cheile încep cu sk_, așa că verificați acest prefix și comparați întregul șir cu copia de pe pagina de cont.
Înlocuiți cheia într-un singur loc și reluați același apel individual. Modificarea mai multor lucruri simultan face rezultatul imposibil de citit.
Când apare un 402 după o reîncărcare
Un 402 înseamnă că acțiunea plătită nu mai are credit. Citiți soldul rămas în _credits la următorul răspuns autentizat înainte de orice altceva.
Dacă acel sold pare corect, comparați-l cu costul apelului care a eșuat. Numerele vor arăta dacă apelul este pur și simplu mai mare decât soldul.
Țineți o notă a momentului în care ați reîncărcat, astfel încât jurnalul și soldul să poată fi comparate ulterior.
O scurtă notă a soldului înainte și după fiecare reîncărcare face următorul 402 mai ușor de citit.
Parcurgerea unui rezultat gol
Confirmați că apelul s-a finalizat
Citiți mai întâi ok. O valoare false înseamnă că apelul nu s-a terminat, așa că o listă goală nu vă spune nimic despre domeniu.
Verificați numele trimis
Valoarea q trebuie să fie un domeniu simplu. Un protocol, un path sau un spațiu pierdut pot produce un răspuns gol care arată ca unul real.
Comparați cu o acțiune gratuită
Rulați overview pe același nume. Dacă acesta returnează date, iar listarea nu, acțiunea de listare și limitele acesteia sunt următorii suspectați.
Verificați data de reîmprospătare
Indexul se actualizează aproximativ o dată pe lună. Un link adăugat după ultima reîmprospătare nu va apărea, indiferent de câte ori apelați endpoint-ul.

Politica minimală de retry
- Nu repetați automat un 401 sau un 402
- Repetați erorile de rețea cu întârzieri crescătoare
- Opriți-vă când _credits arată un sold aproape de zero
- Stocați în cache răspunsurile reușite pentru lună
- Logați acțiunea și domeniul cu fiecare eșec
Întrebări de margine
Sunt deduse credite pentru un apel eșuat?
Nu specificăm o regulă de facturare pentru apelurile eșuate în această referință. Urmăriți _credits la următorul răspuns autentificat și comparați soldul rămas cu așteptarea dvs.
De ce funcționează o acțiune gratuită după un 402?
Pentru că domain, overview, stats și suggest nu necesită cheie și nici credit. Doar acțiunile plătite sunt blocate când soldul este gol.
De unde provin numele câmpurilor?
Consultați intrarea despre câmpurile API pentru forma generală și apelați un endpoint live pentru rânduri specifice acțiunii.
De ce un scor poate părea greșit fără nicio eroare
Uneori toate câmpurile ajung la timp, iar numărul vă surprinde totuși. Răspunsul este corect pentru instantaneul său, așa că întrebarea reală este ce conține acel instantaneu.
Trei situații explică majoritatea acestor cazuri.
Un domeniu lansat recent
Un site lansat recent poate afișa DR 0 deoarece instantaneul precede linkurile sale. Zero aici înseamnă că nu a fost găsit niciun domeniu care face referire, nu un verdict asupra site-ului.
Așteptați o reîmprospătare ulterioară înainte de a citi cifra ca pe un judecat asupra site-ului.
Comparați vârsta domeniului cu ciclul de reîmprospătare înainte de a acționa. Un nume nou și un nume vechi care nu a atras niciodată linkuri arată la fel în același instantaneu.
Un link care a sosit această lună
Linkurile adăugate după ultima reîmprospătare lipsesc din cifră. Un apel repetat returnează același răspuns până la sosirea următoarei reîmprospătări.
Notați data linkului și data instantaneului, astfel încât decalajul să fie ușor de explicat oricui citește raportul.
Un link care a dispărut
Un link poate dispărea când pagina sa este ștearsă sau site-ul donator se închide. Numărătoarea scade apoi, deși nu s-a schimbat nimic din partea dvs.
Comparați două instantanee la câteva luni distanță înainte de a da vina pe endpoint.
Numărați câte domenii se mută, nu doar totalul. O pierdere mică răspândită pe multe site-uri se citește diferit de o pierdere mare de la un singur site.
Unde se află fiecare remediu
| Remediu | Loc |
|---|---|
| Cheie nouă sau copiată | Pagina de cont |
| Reîncărcare în USDT (TRC-20) | Pagina de cont |
| Fragmentare și retry | Codul client propriu |
| Așteptarea unei reîmprospătări | Nimic de făcut; indexul se actualizează aproximativ lunar |

Reproducerea unui eșec pentru un raport de bug
Reduceți la un singur apel
Eliminați bucla și păstrați o singură comandă curl care eșuează.
Înregistrați răspunsul
Notați statusul HTTP, valoarea ok și câmpul _credits dacă este prezent.
Încercați o acțiune gratuită pe același domeniu
Dacă overview funcționează, iar acțiunea plătită nu, vina este a cheii sau a soldului, nu a domeniului.
Trimiteți detaliile
Notați timpul, acțiunea și primele și ultimele caractere ale cheii, astfel încât apelul să poată fi asociat cu contul. Păstrați cheia completă în afara raportului.
Ce să înregistrați cu fiecare apel eșuat
| Înregistrați | De ce ajută |
|---|---|
| Status HTTP | Separează un 401 de un 402 la o privire |
| Valoarea ok | Arată dacă apelul s-a finalizat |
| _credits, când este prezent | Arată soldul la momentul eșecului |
| Acțiune și domeniu | Vă permite să repetați același apel intenționat |
| Timpul apelului | Îl plasează în raport cu reîmprospătarea lunară |
De ce nu auto-retry
Buclarea pe un 402 arde timp și nu aduce nimic. Buclarea pe un 401 poate declanșa detectarea abuzului la orice furnizor, al nostru sau Google.
Rezervați retry-urile pentru erorile de rețea și acordați fiecărui retry o pauză mai lungă decât precedenta. Trei încercări este un prag rezonabil pentru un job nocturn.
Să presupunem că un job nocturn întâlnește un 402 la două dimineața. Repetarea la fiecare cinci minute până la micul dejun produce aproximativ o sută de eșecuri identice, iar fiecare este o linie de jurnal pe care cineva trebuie să o citească ulterior.
Utilizați un prag fix și pentru retry-urile de rețea și logați fiecare încercare. Un prag pe care îl puteți enuncia într-o singură propoziție este ușor de apărat când un job se oprește.
Alerte pentru un job care rulează neîngrijit
Un job nocturn de verificare a scorului domeniului ar trebui să anunțe pe cineva când se oprește și ar trebui să spună de ce. Cele două coduri necesită alerte diferite, așa că țineți-le separate în mesaj.
Alertați la primul 401
Un singur 401 înseamnă de obicei o problemă de cheie, așa că un singur eșec merită un mesaj. Așteptarea unei sute de eșecuri identice amână doar remedierea.
Includeți primele și ultimele caractere ale cheii în alertă, nu întreaga cheie, astfel încât mesajul să fie sigur de partajat cu un coleg.
Un 402 merită un mesaj propriu, deoarece remedierea sa este o reîncărcare, nu o schimbare de cheie.
Un job liniștit nu este neapărat unul sănătos. Numărați rulările care s-au finalizat, nu doar pe cele care au eșuat, și alertați când niciun număr nu se mișcă pentru un ciclu întreg.
Alertați la un sold în scădere
Setați avertismentul la un nivel care acoperă restul rulării, nu la zero. Un sold aproape gol când începe jobul nu lasă loc pentru retry-uri.
Citiți nivelul din _credits la fiecare răspuns autentificat, astfel încât avertismentul să nu necesite o cerere suplimentară.
Crawler-ul nostru și indexul nostru de linkuri se reîmprospătează aproximativ o dată pe lună. Un site lansat recent poate afișa DR 0, iar aceasta este o citire corectă a instantaneului, deoarece acesta nu conține încă niciun domeniu care face referire pentru site.