Průvodce nastavením

Počítadlo zpětných odkazů pro SaaS dashboard, krok za krokem

Funkční počítadlo vyžaduje jednu serverovou trasu a jeden malý komponent. Tento průvodce vytvoří obě části, včetně stavů selhání, které první verze často přehlížejí.

Redakce AlfaLinks · Aktualizováno 2026-10-29

Řemeslník skládající pět mechanických ozubených kol na dřevěné dílenské lavice reprezentující kroky dashboardu

Rozsah tohoto průvodce

Předpokládáme backend v Node nebo Pythonu a libovolný front-end framework. Každý požadavek níže zasahuje do zdokumentovaného API a základní URL je vlastní vaše značka: alfalinks.net/api.php.

Pět kroků v pořadí, v jakém bychom je nasadili

1. Vytvořte klíč a uložte jej jako tajný údaj

Přihlaste se přes Google na /auth/google.php, zkopírujte klíč sk_ ze stránky účtu a umístěte jej do prostředí serveru. Front-end ho nikdy neuvidí.

2. Přidejte jednu proxy trasu

Zveřejněte něco jako /internal/links?domain=..., což ověří doménu, zavolá naše API a vrátí pouze pole, která vaše UI používá. Ověření je důležité, protože uživatelé zadávají cokoliv.

3. Začněte s bezplatnou akcí

Akce overview nic nestojí, takže první verze počítadla nemá žádný riziko fakturace. Přejděte na placené akce, až když to obrazovka bude vyžadovat.

4. Vykreslete tři stavy

Načítání, data a nedostupné. Nedostupné pokrývá HTTP 401, HTTP 402 a selhání sítě a nikdy by nemělo zobrazovat nulu.

5. Přidejte označení čerstvosti dat

Náš index se obnovuje přibližně měsíčně. Šedý řádek s textem 'data o odkazech aktualizována měsíčně' zabrání ticketu na podporu, který začíná větou 'Přidal jsem odkaz včera'.

Proxy trasa v Node

Dostatečně krátké na přečtení na jednu obrazovku. Cache je zde běžná Map; přepněte na Redis, jakmile budete provozovat více než jeden proces.

const cache = new Map();
const MONTH = 30 * 24 * 3600 * 1000;

app.get('/internal/links', async (req, res) => {
  const domain = String(req.query.domain || '').toLowerCase().trim();
  if (!/^[a-z0-9.-]+\.[a-z]{2,}$/.test(domain)) return res.status(400).json({ok:false});
  const hit = cache.get(domain);
  if (hit && Date.now() - hit.t < MONTH) return res.json(hit.v);
  const r = await fetch(`https://alfalinks.net/api.php?action=overview&q=${domain}`);
  if (!r.ok) return res.status(502).json({ok:false});
  const v = await r.json();
  cache.set(domain, {t: Date.now(), v});
  res.json(v);
});

Zahradník používající širokou síť k chytání hejna ptáků reprezentující hromadné požadavky na domény

Přidání odznaku DR po zprovoznění počítadla

Počítadlo je ta snazší polovina. Odznak vyžaduje jeden další požadavek.

Pro tabulku domén zákazníků pošlete jediný požadavek bulk_dr s až 2 000 doménami místo jednoho volání na řádek. Stojí to 1 kredit bez ohledu na počet řádků a odpověď mapuje každou doménu na její hodnotu 0–100, kterou uložíte vedle cached overview.

Srovnejte domény podle normalizovaného hostname. Odstraňte protokol, cestu a úvodní www, jinak vám polovina řádků unikne a zobrazí se prázdná pole.

Přečtěte si poznámky k hodnocení pro formulaci popisků a recept na cache pro TTL u těchto volání.

Nejprve zobrazte hodnotu, poté požádejte o nastavení

Noví uživatelé zřídka čtou stránky s nastavením. chtějí vidět, zda je funkce za námahu stojí, a počítadlo zpětných odkazů, které ukazuje reálné číslo, odpoví rychleji než jakýkoli formulář. Umístěte hodnotu na první místo. Konfigurace přijde na druhém místě.

Protože bezplatná akce overview nepotřebuje klíč, může první obrazovka zobrazit číslo ještě než uživatel něco nakonfiguroval.

Co potřebuje první vykreslení?

Pouze jednu doménu a jedno bezplatné volání. Představte si nového uživatele, který zadá svou vlastní stránku do onboarding procesu a uvidí počítadlo objevit se ve stejném pohledu na stránku. Toto jediné číslo více pomůže k zahájení nastavení než seznam kroků, takže zbytek nastavení ponechte za ním.

Uživatel uvidí, co dostane, než ho někdo požádá o kartu, klíč nebo druhý formulář. Nic na prvním vykreslení by nemělo vypadat jako brána.

Kde by měl být výzva k nastavení?

Hned za číslem, ne před ním. Krátký řádek jako 'Připojte doménu pro sledování každý měsíc' se vejde pod počítadlo. Pokud stejná výzva stojí nad číslem, uživatelé ji čtou jako bránu a odejdou.

Sledujte, kteří uživatelé dokončí každý krok nastavení. Malý funnel ukáže, kde lidé přestávají, a změna formulace často posune toto číslo více než nová funkce.

Testování před spuštěním

Nejprve otestujte nešťastné cesty. Šťastné cesty testují samy sebe.

Zrušte klíč ve staging prostředí a potvrďte, že karta zobrazuje 'nedostupné' místo nuly. Poté vyčerkejte testovací zůstatek, abyste spustili 402, a vložte neplatný vstup, jako je doména s protokolem a koncovou cestou, abyste prokázali, že validátor ji zamítne dříve, než se utratí jakýkoli kredit.

Krátký dýmový test patří do CI. Jedno bezplatné volání overview na nytimes.com, spouštěné každou noc, vám řekne, zda trasa a klíč stále fungují.

Tři železné klíče visící na těžkých dubových dveřích reprezentující pravidla přístupu a limity domén

Kdo může hledat kterou doménu a za jakou cenu

Počítadlo, které přijme jakýkoli řetězec, je otevřenými dveřmi k vašemu zůstatku. Rozhodněte, kdo může požádat o co, dříve než trasa půjde do produkce, a zapište odpověď do kódu, nikoliv do wiki stránky, kterou nikdo neotevírá.

Tři otázky se objevují vždy: které domény, jaký limit a kde se nachází klíč.

Které domény by měl uživatel smět zadat?

Pouze ty, ke kterým má pracovní prostor nárok, plus jakákoliv veřejná hledání, která jste se rozhodli nabídnout. Řekněme, že pracovní prostor vlastní dva weby. Trasa může přijmout tyto dvě a zamítnout cokoli jiného s jasnou zprávou, což zabrání tomu, aby jeden tenant utrácel kredity za domény, které mu nepatří.

Kontrola hostname v trase je minimum. Dokazuje, že vstup vypadá jako doména, ne že ji uživatel vlastní, takže seznam nároků udržujte ve své vlastní databázi jako samostatnou tabulku.

Jak zastavíte jednoho uživatele, který vyčerpá zůstatek?

Umístěte kvótu na pracovní prostor do vašeho úložiště a počítejte tam volání. Zůstatek na naší straně je jeden předplacený fond, takže vám neřekne, který zákazník co utratil. Poznámky k lookup stránce pokrývají veřejnou stranu stejného problému. Když pracovní prostor dosáhne svého limitu, vraťte prostou zprávu a nechte cache, aby nadále odpovídala tím, co již drží.

Vyberte limit z aritmetiky v poznámkách na základě sedadel, ne z odhadu, a zkontrolujte ho při změně plánu. Otestujte trasu s druhým pracovním prostorem, než důvěřujete kvótě.

Měl by prohlížeč někdy držet klíč?

Ne. Klíč žije na vašem serveru a prohlížeč volá vaši trasu. Toto rozdělení je také to, co umožňuje kvótu, protože každé placené volání prochází kódem, který kontrolujete. Pokud se klíč někdy objeví v balíčku, otočte ho tentýž den a zkontrolujte log zůstatku na volání, která jste neudělali. Některé týmy ukládají klíč do konfiguračního souboru, který front-end čte při sestavení, a tento soubor skončí v balíčku. Udržujte klíč mimo dosah všeho, co build krok může vidět, a zkontrolujte odeslané soubory jednou před každým vydáním.

Bezplatné akce mohou být volány z veřejné stránky bez klíče, a to je ten případ, kdy může prohlížeč mluvit s API přímo.

Co by počítadlo mělo říkat, a co ne

Řekněte méně, než víte. Počítadlo označené jako 'zpětné odkazy' vyzývá k otázce 'proč Ahrefs ukazuje jiné číslo?', a upřímná odpověď je, že dva crawlerové vidí dva snímky webu.

Označte číslo jeho zdrojem a měsícem. Něco jako 'Odkazující domény, index AlfaLinks, říjen 2026' je delší, ale ukončí spor, než začne, a čte se dobře v malé kartě.

Zaokrouhlete pro zobrazení. Uživatel, který uvidí 12 481 v pondělí a 12 481 v pátek, důvěřuje nástroji více než ten, kdo vidí jitter, a naše měsíční obnova vám dává tuto stabilitu zdarma.

Pokud chcete vedle toho hodnotu 0–100, přečtěte si nejprve poznámky o skóre zpětných odkazů. Je to náš vlastní metrický údaj, takže na názvu záleží.

Stavy selhání a co UI dělá

Kódy HTTP jsou ty, které API vrací; sloupec UI je naše doporučení.
Signál	Význam	Co uživatel uvidí	Co uděláte
HTTP 401	Chybějící nebo špatný klíč	'Data o odkazech nedostupná'	Stránkujte sami sebe: chyba nasazení
HTTP 402	Kredity došly	'Data o odkazech nedostupná'	Doplňte pomocí USDT (TRC-20)
ok: false	Požadavek zamítnut	Inline odkaz na opakování	Logujte doménu a akci
Časový limit	Problémy se sítí	Cached hodnota, pokud ji máte	Zkuste znovu jednou, poté zpomalte

Udržování počítadla upřímného v podpoře a logech

Počítadlo selhává tiše mnohem častěji, než selhává hlasitě. Logujte dostatek, abyste odpověděli na otázku, kterou zákazník položí příště, a udržujte osobní údaje zcela mimo log. Krátké řádky vyhrávají. Řádek, který odpoví na otázku podpory, ušetří více času než jakékoli upozornění, které byste mohli napsat.

Většina vláken podpory týkajících se počítadla je jedna ze tří otázek, takže naplánujte log kolem nich. Udržujte tyto tři otázky ve své příručce pro provoz, vedle kroků pro rotaci klíče.

Co by měl každý řádek logu zaznamenat?

Akci, doménu, kód stavu, stáří cache a zůstatek kreditu, který se vrátil. Těchto pět polí odpoví na většinu otázek podpory. Řekněme, že uživatel se ptá, proč jeho počítadlo ukazuje staré číslo. Stáří cache a měsíc indexu vám řeknou, zda je problém v cache nebo v popisku.

Nechejte API klíč mimo každý řádek, včetně tras chyb. Maskujte ho v loggeru, protože jeden uniklý řádek může vyčerpat celý účet.

Jak víte, že je počítadlo zdravé každý týden?

Sledujte tři čísla: podíl stavů nedostupnosti, trend zůstatku kreditu a míru zásahu cache. Náhlý skok ve stavu nedostupnosti obvykle ukazuje na problém s klíčem nebo zůstatkem. Pomalý pokles zůstatku obvykle ukazuje na klíč cache, který je příliš specifický.

Každý čtecí má jinou opravu, proto jeden dashboard tile pro všechny tři zřídka někomu pomůže. Umístěte tři čtení na jeden řádek ve své týdenní poznámce, s poslední hodnotou a změnou oproti předchozímu týdnu. Čísla čtená izolovaně lákají na hádání, zatímco krátký trend udržuje konverzaci na stejných faktech.