Co vám připojení přinese
Připojení vlastního klíče Ahrefs znamená, že data o SEO pro vaše weby budeme stahovat pomocí vašeho účtu Ahrefs namísto našeho. Ve svém přehledu uvidíte stejné metriky, které vycházejí z vašeho vlastního předplatného.
Než začnete
Tarif Ahrefs, který zahrnuje přístup k API, a práva vlastníka nebo správce v pracovním prostoru Ahrefs — klíče API mohou vytvářet pouze oni.
1. Vytvořte klíč v Ahrefs
V aplikaci Ahrefs otevřete Account settings → API keys a vytvořte klíč. Každý klíč platí jeden rok a poté přestane fungovat; na stránce se zobrazuje datum vypršení platnosti každého klíče. Na stejné stránce můžete také omezit, kolik jednotek API může klíč každý měsíc využít.
2. Připojte ho zde
Otevřete Integrations ve svém přehledu a zvolte Connect an account. Jako skupinu vyberte Your own SEO data a jako účet Ahrefs, vyplňte položku API key a stiskněte tlačítko Connect account.
To, co vložite, před uložením otestujeme. Nefunkční klíč se nikdy neuloží a v odpovědi se dozvíte, co bylo špatně. Funkční klíč je uložený v zašifrované podobě v našem úložišti tajných údajů – nikdy v naší databázi – a už se nikdy nezobrazí, a to ani vám.
Co se stane potom
- Kontroly autority a zpětných odkazů, které pro vaše weby spouštíme, využívají váš klíč v rámci kvóty vašeho tarifu a přestanou používat náš. Za kontroly spuštěné na váš klíč vám nic neúčtujeme.
- Pokud bude váš klíč odvolán nebo vyprší jeho kvóta, zastavíme provoz a upozorníme vás – na obrazovkách, kde
se metriky zobrazují – namísto tichého přepnutí zpět na náš účet. Opravte klíč u poskytovatele nebo jej odpojte, abyste se vrátili k tomu, co zahrnuje váš tarif.
- Kontroly probíhají podle běžného harmonogramu; připojení klíče nespustí vlnu volání
vůči vaší kvótě.
Pokud se připojení nezdaří
Přestal fungovat po roce. Klíče Ahrefs vyprší po dvanácti měsících. Vytvořte nový a připojte ho.
Kontroly se zastaví s chybovou zprávou o limitu. Měsíční limit jednotek API pro tento klíč nebo limit vašeho tarifu je vyčerpán. Zvyšte limit v nabídce Account settings → API keys nebo počkejte na jeho obnovení.
Zpráva uvádí, že klíč byl odmítnut. Téměř vždy jde o jednu ze tří věcí: s klíčem se zkopírovala mezera nebo zalomení řádku, klíč vypršel nebo byl odvolán či vygenerován znovu po jeho zkopírování. Vytvořte nový a vložte ho znovu.
Připojení proběhne, ale něco později selže. Klíč se autentizuje, ale chybí mu oprávnění, které akce vyžaduje. Vytvořte nový klíč s výše uvedenými oprávněními, poté odpojte staré připojení a připojte nový klíč.
Odpojení
Otevřete Integrations, vyhledejte účet a stiskněte Disconnect. Tím se uložený klíč okamžitě odstraní. Vše, co ho používalo, se při příští akci zastaví a obrazovky, které na něm závisely, na to upozorní namísto tichého selhání.
Odpojení neodčiní to, co již bylo provedeno – záznamy, nasazení nebo nastavení, která jsme změnili na vašem účtu, zůstávají tak, jak jsou. Pokud si myslíte, že mohl uniknout samotný klíč, odvolejte ho také u poskytovatele; odpojením se odstraní naše kopie, nikoli jejich.