Kontrola zpětných odkazů vrátila nic: tabulka chyb

Pravidlo, které pokrývá většinu případů

Opakujte síťové chyby. Nikdy neopakujte 401 ani 402. První typ se sám opraví za několik sekund; druhý vyžaduje zásah člověka a jeho drti jen zaplňuje vaše protokoly.

Každá odpověď JSON obsahuje pole ok, a ty ověřené přidávají _credits s náklady na volání a zbývajícím zůstatkem. Zkontrolujte ok v těle odpovědi, i když stav HTTP vypadá v pořádku.

Časy opakování níže jsou naším inženýrským doporučením, ne zdokumentovanými limity. Dokumentace API, kterou máme, nezveřejňuje limit rychlosti, takže si nastavte vlastní strop a udržujte ho skromný.

Proč 401 a 402 nikdy neopakovat

401 je problém s klíčem a 402 je problém s zůstatkem. Ani jedno se neopraví mezi dvěma pokusy oddělenými sekundou, takže opakování přidává šum do protokolů a nic dalšího.

Čekání také neopraví 402. Zůstatek zůstává tam, kde je, dokud ho někdo nenabije na stránce účtu, takže jedinou užitečnou reakcí je jasná zpráva a upozornění pro toho, kdo spravuje rozpočet.

401 si zaslouží pohled na hlavičku nebo parametr klíče a kontrolu, zda nebyl klíč nahrazen. Opakování se špatným klíčem několikrát nic neprokáže.

Špatný klíč a prázdný zůstatek také vypadají na vašem dashboardu odlišně. Mějte je v samostatných upozorněních, aby člověk, který dobíjí, nebyl probuzen překlepem v klíči, a člověk, který klíče rotuje, nebyl vyvolán pro zůstatek.

Síťové chyby a backoff

Časový limit nebo reset připojení se mohou vyřešit samy, takže to jsou jediné případy, které stojí za další pokus. Počkejte 1, 2, 4 a poté 8 sekund, přidejte trochu jitteru a po čtvrtém pokusu přestaňte.

Tyto časy jsou naše doporučení, ne zdokumentovaný limit. Udržujte vlastní strop, protokolujte každé opakování a upozorněte, když počet opakování roste, protože rostoucí míra opakování je obvykle prvním znakem problému nadřazené služby.

Udržujte časový limit na své straně explicitní, v pojmenované konstantě. Implicitní výchozí hodnota, která se změní při aktualizaci knihovny, je častým důvodem, proč noční úloha začne selhávat pouze na jednom stroji.

Sledujte také dobu odpovědi nadřazené služby a míru selhání. Pomalá odpověď, která nikdy neselže, může stále obsazovat vaše pracovníky a smyčka opakování tento zpomalení zhorší.

Normalizujte doménu před voláním

Většina selhávajících volání začíná ve vstupním poli, ne v síti. Uživatelé vloží cokoliv, co zkopírovali, a váš kód musí to převést na holou doménu, než API uvidí.

Odstranit schéma a cestu

Odstraňte schéma, jakoukoli cestu a query string. Vložená adresa článku se stane svým hostitelem a pouze hostitel jde nahoru.

Převeďte hostitele také na malá písmena. Udržujte čištění v jedné funkci, aby se stejné pravidlo spouštělo ve formuláři, v dávkové úloze i v testech.

Otestujte čištění s pěti nebo šesti reálnými vloženými vstupy, včetně jednoho s koncovým lomítkem a jednoho s query stringem. Tyto případy odhalí chyby, které čistý příklad nikdy neukáže.

Rozhodněte se jednou, co dělat s www.

Vyberte jedno pravidlo pro www. a aplikujte ho v jedné funkci, aby se stejný web nikdy nehledal pod dvěma pravopisy.

Zapište pravidlo vedle funkce. Další vývojář, který narazí na potulné www, pak najde rozhodnutí, ne druhý názor.

Ať už pravidlo zvolíte jakékoliv, udržujte ho v jednom souboru a napište pro něj jeden test. Test je záznam rozhodnutí a je krátký.

Odmítnout to, co nemůže být doménou

Odmítněte vstup s mezerami nebo prázdnými štítky a zobrazte krátkou zprávu ve formuláři. Odmítnutý řetězec nic nestojí, zatímco špatný stojí selhání volání a zmateného uživatele.

Koncové tečky jsou podivný případ. Odstraňte jednu na konci hostitele a cokoli jiného považujte za neplatné.

Zobrazte odmítnutí vedle pole, ne jako toast, který zmizí. Uživatel, který vidí, co bylo špatně, to opraví na první pokus.

Prázdné výsledky a stáří indexu

Když někdo zadá kontrolu zpětných odkazů do vašeho formuláře a nedostane nic, prázdná odpověď není vždy chybou. Často to znamená, že doména je nová, příliš malá nebo prostě ještě není v indexu, a obrazovka by měla říct, která.

Zcela nový web

Web spuštěný minulý týden může mít v indexu žádné odkazující domény. Zobrazte „ještě neindexováno“ společně s datem indexu a nabídněte bezplatné volání overview jako křížovou kontrolu.

Neukládejte tuto prázdnou odpověď dlouho. Pár hodin stačí a další rebuild může web přidat.

Řekněte návštěvníkovi, kdy byl index naposledy obnoven, srozumitelnými slovy. Datum vedle prázdné odpovědi vysvětlí mezeru lépe než delší zpráva.

Zde stačí poznámka na jeden řádek ve vašem UI. Nikdo neočekává živý index a obyčejná věta vedle data indexu působí upřímně.

Číslo, které nesouhlasí s jiným nástrojem

Různí crawlerové vidí různé části webu. Čtěte hodnotu DR jako pozici uvnitř jednoho nástroje a nasměrujte čtenáře na odkaz na DR pro vzorec.

Krátká poznámka pod číslem ušetří více času na podpoře než jakékoli množství omluvy po věci.

Pokud se dvě čtení liší, nejprve porovnejte počty odkazujících domén. Vzorec DR je jednoduchý, takže většina nesrovnalostí se redukuje na počet.

Řádky končí na 50 000

Když seznam končí na stropu, odpověď je správná pro to, co API umožňuje. Označte mezní hodnotu a propojte poznámky k stránkování místo pokusu o hlubší stránku.

Hlubší stránky za tímto bodem nejsou opakováním. Jsou to jiný dotaz a jejich považování za jeden je způsob, jakým smyčka běží hodiny.

Udržujte mezní hodnotu viditelnou i v exportu, aby se v tabulce otevřené o měsíc později stále zobrazovalo, že seznam byl omezen.

Zobrazení počtu řádků vedle tabulky změní mezní hodnotu na viditelný fakt. Čtenář, který vidí 50 000 řádků, ví, že se zeptat na užší otázku.