API klíče

API klíč ověřuje externí systém a váže jeho přístup na jednu firmu, zdroj a konkrétní schopnosti.

Pokud má firma tým, připojení a odpojení integrací, vytvoření a zrušení API klíče i změny souhlasu DPA a uchovávání dat vyžadují čerstvé dvoufázové ověření. Samostatný vlastník bez týmu pro tyto akce MFA nepotřebuje.

Vytvoření API klíče

Vlastník firmy vytvoří klíč v Nastavení → Integrace → API klíče výběrem typu integrace. Pro vlastní napojení zvolte Vlastní API. Název určuje typ, nezadává se volně. Klíč začíná rep_live_ a celý se zobrazí jen při vytvoření. Uložte jej na serveru; nevkládejte jej do veřejného JavaScriptu. Vlastník jej může odvolat.

Po zavření dialogu klíč znovu nezobrazíme. Pokud jej ztratíte, musíte vygenerovat nový a aktualizovat ho ve všech integracích.

Vlastní API a Zapier: Pro nebo Business. Klíče WooCommerce, Shoptet, Wix a Upgates: od Starter. Power BI: Pro nebo Business a dostupná funkce exportu. Free nemá příjem kontaktů. Platí oprávnění aktuálního tarifu včetně platné zkušební doby; po jejím vypršení bez předplatného se přístup omezí. Samotný úspěšný GET collect tarif nekontroluje.

Přejít na správu API klíčů

Použití API klíče

Použijte hlavičku Authorization: Bearer rep_live_REPLACE_ME. Jen jednotlivý POST collect přijímá také api_key v JSON těle pro konektory bez podpory hlaviček. Použitelná Bearer hlavička má přednost. GET a batch vyžadují hlavičku.

Klíč patří jedné firmě a má pevný zdroj a schopnosti. collect:write dovoluje příjem kontaktů; WooCommerce navíc product_reviews:write. Klíč Power BI má pouze analytics:read a collect odmítne. Zdroj v těle se musí přesně shodovat se zdrojem klíče. Libovolné názvy zdrojů ani custom nejsou platné; vlastní integrace používá api.

Dokumentace pro vývojáře

Bezpečnost

Nikdy nesdílejte klíč veřejně

API klíč nesmí být součástí veřejného kódu (GitHub, frontend JavaScript). Používejte ho pouze na serveru.

Jeden klíč pro každou integraci

Vytvořte samostatný klíč pro každou platformu. Pokud dojde ke kompromitaci, stačí zrušit pouze jeden klíč.

Zrušení klíče

Kompromitovaný nebo nepotřebný klíč okamžitě smažte v Nastavení → Integrace → API klíče.

Limity

POST collect a batch sdílejí limit 60 požadavků za klouzavých 60 sekund. U Bearer klíče se limit odvozuje z prvních 23 znaků klíče; bez Bearer hlavičky z IP. Dávka se počítá jako jeden požadavek. GET collect tento limiter nepoužívá. Odpovědi collect neposílají Retry-After ani hlavičky zbývajícího limitu. Kód nestanovuje denní limit příjmu ani maximální počet API klíčů; při nedostupnosti limiteru příjem pokračuje.

Limity a opakování