Verifică-mi backlink-ul nu a returnat nimic: un tabel de erori
Instrumentul tău este la fel de stabil pe cât este gestionarea erorilor sale. Mai jos, eșecurile care apar de fapt, cauza exactă și dacă o reîncercare are sens.
Regula care acoperă majoritatea cazurilor
Reîncearcă erorile de rețea. Nu reîncerca niciodată 401 sau 402. Prima categorie se rezolvă singură în câteva secunde; a doua necesită un om, iar bombardarea acesteia umple doar jurnalele de erori.
Fiecare răspuns JSON conține un câmp ok, iar cele autentificate adaugă _credits cu costul apelului și soldul rămas. Verifică ok în corpul răspunsului chiar și când statusul HTTP pare corect.
Timpurile de reîncercare de mai jos sunt sfaturile noastre de inginerie, nu limite documentate. Documentația API pe care o deținem nu publică o limită de rată, așa că construiește-ți propria limită și menține-o moderată.
De ce 401 și 402 nu se reîncearcă niciodată
Un 401 este o problemă de cheie, iar un 402 este o problemă de sold. Niciunul nu se rezolvă între două încercări la o secundă distanță, așa că o reîncercare adaugă zgomot în jurnale și nimic altceva.
Așteptarea nu rezolvă nici un 402. Soldul rămâne neschimbat până când cineva îl reîncarcă din pagina de cont, astfel că singura reacție utilă este un mesaj clar și o alertă către persoana care deține bugetul.
Un 401 merită o privire asupra antetului sau a parametrului cheie, și o verificare că cheia nu a fost înlocuită. Reîncercarea aceleiași chei greșite de câteva ori nu dovedește nimic.
O cheie invalidă și un sold gol arată diferit în panoul tău de control. Pune-le pe alerte separate, astfel încât persoana care reîncarcă soldul să nu fie trezită de o greșeală de tastare a cheii, iar persoana care rotește cheile să nu fie alertată pentru un sold.
Erori de rețea și backoff
Un timeout sau o resetare a conexiunii se pot rezolva singure, așa că acestea sunt singurele cazuri care merită o nouă încercare. Așteaptă 1, 2, 4 și apoi 8 secunde, adaugă puțin jitter și oprește-te după a patra încercare.
Aceste timpi sunt sfatul nostru, nu o limită documentată. Menține-ți propria limită, loghează fiecare reîncercare și alertează când numărul de reîncercări crește, deoarece un ritm crescut de reîncercări este de obicei primul semn al unei probleme la nivel de amonte.
Menține timeout-ul din partea ta explicit, într-o constantă cu nume. Un implicit implicit care se schimbă la o actualizare a bibliotecii este un motiv comun pentru care un job nocturn începe să eșueze pe o singură mașină.
Urmărește timpul de răspuns al amontului, precum și rata de eșec. Un răspuns lent care nu eșuează niciodată poate totuși să îți ocupe lucrătorii, iar un loop de reîncercare agravează această încetinire.
Simptom, cauză, răspuns
| Simptom | Cauză | Reîncercare? | Ce să faci |
|---|---|---|---|
| HTTP 401 | Cheie lipsă, tastată greșit sau revocată | Nu | Verifică antetul sau valoarea key=, apoi pagina de cont |
| HTTP 402 | Creditul s-a epuizat | Nu | Reîncarcă în USDT (TRC-20) din pagina de cont; aceeași cheie reia funcționarea |
ok nu este adevărat pe HTTP 200 | Parametru greșit, de exemplu o URL unde ar trebui să fie un domeniu | Nu | Validează inputul; trimite example.com, nu https://example.com/page |
| Timeout sau resetare a conexiunii | Zgârietura de rețea sau a amontului | Da, de 3 până la 4 ori | Backoff 1, 2, 4, 8 secunde cu jitter |
| Rezultat gol pentru un site nou | Nu este încă în index; reîmprospătarea este lunară | Nu | Afișează „nu este încă indexat” împreună cu data indexului |
| Numărul diferă de al unui alt instrument | Index diferit și o formulă DR diferită | Nu | Compară tendințele în cadrul unui singur instrument, vezi referință DR |
| Rândurile se opresc la 50.000 | Limita de paginare | Nu | Vezi notele de paginare |
| Soldul scade mai repede decât era planificat | Acțiune plătită într-un loop, sau un apel de 3 credite pe o cale fierbinte | n/a | Loghează _credits, permite-listează acțiunile |
Înainte de a-ți acuză codul, lipește URL-ul care eșuează în cURL cu aceeași cheie. Dacă funcționează acolo, bug-ul este în clientul tău. Dacă eșuează și acolo, răspunsul este în tabel. Această verificare a rezolvat mai multe tichete decât orice căutare în jurnale.
Un runde de depanare, în ordine
- 1
Reproduci cu curl
Ia URL-ul care eșuează din aplicația ta și rulează-l manual cu aceeași cheie. Dacă curl funcționează, codul tău este problema.
- 2
Încearcă o acțiune gratuită
overviewpe același domeniu nu necesită cheie. Dacă răspunde, indexul este corect și problema este în autentificare sau credit. - 3
Citește soldul
Un 402 este ambiguu, dar un apel plătit care eșuează după un succes gratuit indică de obicei creditul sau o greșeală de tastare a cheii.
- 4
Verifică inputul
Litere mici, fără scheme, fără cale, fără punct final. Majoritatea eșecurilor
okse termină aici.
Normalizează domeniul înainte de apel
Majoritatea apelurilor eșuate încep în caseta de input, nu în rețea. Utilizatorii lipesc orice au copiat, iar codul tău trebuie să transforme asta într-un domeniu gol înainte ca API-ul să vadă inputul.
Elimină schema și calea
Elimină schema, orice cale și șirul de interogare. O adresă de articol lipită devine gazda sa, și doar gazca merge la amonte.
Transformă gazda în litere mici. Păstrează curățarea într-o singură funcție, astfel încât aceeași regulă să ruleze în formular, în jobul batch și în teste.
Testează curățarea cu cinci sau șase inputuri reale lipite, inclusiv unul cu o bară oblică finală și unul cu un șir de interogare. Acele cazuri scoate la iveală bug-urile pe care un exemplu curat nu le arată niciodată.
Decide o dată ce să faci cu www.
Alege o singură regulă pentru www. și aplic-o într-o singură funcție, astfel încât același site să nu fie căutat sub două scrieri.
Scrie regula lângă funcție. Următorul developer care întâlnește un www răzleț va găsi apoi decizia, nu o a doua opinie.
Indiferent de regula pe care o alegi, păstreaz-o într-un singur fișier și scrie un singur test pentru ea. Testul este înregistrarea deciziei și este scurt.
Respinge ceea ce nu poate fi un domeniu
Refuză inputul cu spații sau etichete goale și afișează un mesaj scurt în formular. Un șir respins nu costă nimic, în timp ce unul prost costă un apel eșuat și un utilizator confuz.
Punctele finale sunt cazul ciudat. Elimină unul la sfârșitul gazdei și tratează orice altceva ca fiind invalid.
Afișează respingerea lângă câmp, nu ca un toast care dispare. Un utilizator care poate vedea ce a mers greșit îl repară într-o singură încercare.
Nu tipări niciodată o eroare brută de amonte în interfață. Mapază 401 și 402 la un „serviciu indisponibil” generic și trimite detaliul în propriul tău jurnal și într-o alertă. Vizitatorii nu își pot repara soldul tău, iar mesajul face ca instrumentul tău să pară stricat.
Rezultate goale și vârsta indexului
Când cineva tastează verifică-mi backlink-ul în formularul tău și nu primește nimic, un răspuns gol nu este întotdeauna o eroare. Înseamnă adesea că domeniul este nou, prea mic sau pur și simplu nu este încă în index, iar ecranul ar trebui să spună care este cazul.
Un site nou lansat
Un site lansat săptămâna trecută poate să nu aibă domenii de referință în index. Afișează „nu este încă indexat” împreună cu data indexului și oferă apelul gratuit overview ca verificare încrucișată.
Nu cache-ui acel răspuns gol pentru mult timp. Câteva ore sunt de ajuns, iar următoarea reconstrucție poate aduce site-ul în index.
Spune vizitatorului când a fost reconstruit ultima dată indexul, în cuvinte simple. O dată lângă un răspuns gol explică decalajul mai bine decât un mesaj mai lung.
Un note de o linie în propria ta interfață este de ajuns aici. Nimeni nu se așteaptă la un index live, iar o propoziție simplă lângă data indexului se citește ca fiind onestă.
Un număr care nu este de acord cu un alt instrument
Crawlere diferite văd fâșii diferite ale webului. Citește figura DR ca pe o poziție în cadrul unui singur instrument și indică cititorilor către referința DR pentru formulă.
Un note scurt sub figură salvează mai mult timp de suport decât orice cantitate de scuze după faptă.
Dacă două citiri diferă, compară mai întâi numărul de domenii de referință. Formula DR este simplă, astfel că majoritatea neconcordanțelor se rezumă la număr.
Rânduri care se opresc la 50.000
Când o listă se oprește la plafon, răspunsul este corect pentru ceea ce permite API-ul. Etichetează tăierea și leagă notele de paginare în loc să încerci o pagină mai profundă.
Paginile mai profunde dincolo de acel punct nu sunt o reîncercare. Sunt o interogare diferită, și tratamentul lor ca pe una este modul în care un loop rulează ore întregi.
Păstrează tăierea vizibilă și în export, astfel încât un spreadsheet deschis o lună mai târziu să arate totuși că lista a fost limitată.
Afișarea numărului de rânduri lângă tabel transformă o tăiere într-un fapt vizibil. Un cititor care vede 50.000 de rânduri știe să ceară o întrebare mai îngustă.
Înainte ca codul de reîncercare să fie lansat
- 401 și 402 nu se reîncearcă niciodată
- Timeout-urile se reîncearcă cu backoff și un număr fix de încercări
- Fiecare răspuns este verificat pentru
ok, indiferent de statusul HTTP - Inputul este normalizat înainte de apel, nu după ce eșuează
- Erorile de amonte merg în propriul tău jurnal, iar vizitatorii văd un mesaj generic
- Un rezultat gol arată data indexului în loc de un ecran gol
Întrebări conexe
- Pot utilizatorii mei să tasteze orice URL în căsuță?
- Lasă-i să, apoi normalizează-l tu însuți. Elimină schema, calea, șirul de interogare și
www.dacă alegi să o faci, transformă gazda în litere mici și abia apoi apelează API-ul. Amontul se așteaptă la un domeniu gol, astfel că inputul necurat este cauza cea mai comună a unui apel eșuat. - Ar trebui să cache-uiesc eșecurile?
- Cache-uiește un rezultat gol „nu este indexat” pentru câteva ore, deoarece indexul se schimbă doar lunar. Nu cache-ui niciodată un 401 sau 402 pentru mult timp. Acestea se rezolvă în momentul în care cheia sau soldul sunt reparate, iar un error cache-uit ar ascunde repararea.
- Acțiunile gratuite se numără la ceva?
- Nu costă credite. Cele patru gratuite sunt
domain,overview,statsșisuggest. Totuși, cache-uiește-le, deoarece a fi politicos nu costă nimic și îți menține propria latență scăzută.
