Klíče a autentizace
Obchod má dva druhy klíčů a API se podle nich dělí. Veřejný klíč je na stránce obchodu a smí jen to, co smí zákazník. Tajný klíč zůstává na vašem serveru a jako jediný dokáže potvrdit cenu.
Cesty, názvy polí, chybové kódy, názvy hlaviček a ukázky kódu zůstávají anglicky: jsou součástí kontraktu.
Veřejný klíč a tajný klíč
Veřejný klíč putuje v URL jako ?key=. Je veřejný záměrně: je ve zdrojovém kódu vaší stránky a funguje jen z originů, které jsou u něj uvedeny. Tajný klíč putuje jako Authorization: Bearer <key> a je jen pro váš server. Prohlížeč jej službě ani nemůže poslat: Authorization není v seznamu povolených hlaviček CORS.
| Klíč | Hlavička | Cesta |
|---|---|---|
| veřejný | ?key=pk_… | GET /cfg/v1/config/public · GET /cfg/v1/catalog/search · POST /cfg/v1/preview · POST /cfg/v1/quote · POST /cfg/v1/order · POST /cfg/v1/projects · GET /cfg/v1/projects · GET /cfg/v1/projects/{id} · POST /cfg/v1/projects/{id} · POST /cfg/v1/projects/{id}/duplicate · POST /cfg/v1/projects/{id}/reorder |
| tajný | Authorization: Bearer sk_… | POST /cfg/v1/quote/verify · GET /cfg/v1/orders/{id} |
Povolené originy
Každý veřejný klíč nese seznam až 20 originů: schéma, hostitel a port přesně tak, jak je posílá prohlížeč, například https://shop.example.com. Požadavek z jakéhokoli jiného originu je zamítnut s 403 origin_not_allowed, včetně preflight požadavku, a služba nikdy neodpovídá s Access-Control-Allow-Origin: *. Seznam je signál, ne autentizace: skutečnou obranou jsou cena počítaná na serveru a limity četnosti.
Testovací klíče
Ostrý obchod může vytvořit až 3 testovacích klíčů (pk_test_…, sk_test_…). Testovací klíč počítá cenu podle vašeho nejnovějšího ověřeného konceptu, takže změnu vyzkoušíte ještě před publikací. Nefakturuje se, jeho objednávky neodesílají žádný webhook ani e-mail a vyprší po 30 dnech. Test a ostrý provoz se nikdy nemíchají: testovací nabídka se ověří jen testovacím tajným klíčem, testovací objednávku vidí jen testovací klíč a ostrý klíč ji nikdy neuvidí. Testovací klíč může mít jako origin http://localhost.
Token projektu
Uložené projekty patří zákazníkovi, ne přihlášení. První POST /cfg/v1/projects vydá náhodný token (cfgpt_…) a vrátí jej jen jednou; vložený konfigurátor jej uchovává a posílá jako X-Cfg-Project-Token při každém dalším volání projektu. Token jiného zákazníka, klíč jiného obchodu i neznámé id odpovídají stejně: 404.
Rotace bez výpadku
Rotace se provádí v konzoli a každý druh klíče má překryv, aby se při přechodu nic nerozbilo.
- Veřejný klíč: nový klíč má stejný seznam originů; starý funguje ještě 168 hodin ve výchozím nastavení (nejvýše 720).
- Tajný klíč: zobrazí se jednou; starý klíč dál autentizuje 24 hodin ve výchozím nastavení (nejvýše 720).
- Klíč pro podepisování nabídek: nový klíč podepisuje od teď; nabídky podepsané starým klíčem se dál ověří a lze je objednat ještě po dobu až 31 dnů.
- Tajemství webhooku: během přechodu podepisují každé doručení obě tajemství po dobu 7 dnů, jako dvě hodnoty
v1=, takže váš přijímač může použít kterékoli.
Co do prohlížeče nepatří nikdy
Tajný klíč a tajemství webhooku (whsec_…). Uchovávejte je v prostředí svého serveru, nikdy na stránce, v repozitáři ani v logu. Pokud jedno unikne, vyměňte jej v konzoli.
Tlačítko „vyzkoušet“ tu záměrně není: tajný klíč patří na váš server, nikdy do prohlížeče. Demo obchod ukazuje vložení i předání objednávky v provozu od začátku do konce.
Právní informacePodmínky konfigurátoru (EN) ·Smlouva o zpracování údajů (EN) ·Zásady ochrany osobních údajů pro kupující ·Licence třetích stran (EN)