Integrace

​

Definice

Na stránce Nastavení → Integrace & API propojíte TWICE se zbytkem svého technologického stacku. Najdete tu identifikátor, přihlašovací údaje a endpointy webhooků, které externí systémy potřebují ke čtení dat z TWICE nebo k jejich odesílání do TWICE.

​

Co administrace nabízí

Poskytovatele plateb nastavíte samostatně v Nastavení → Platby, ne zde.

​

ID účtu

Každé volání API i každý payload webhooku odkazuje na ID obchodníka (identifikátor tenanta). Karta ID účtů ho zobrazuje s možností zkopírovat jedním kliknutím. Sdílejte ho s každým partnerem nebo vývojářem, který se integruje s vaším účtem.

​

Klíče API

Pro každou integraci vytvořte v části Klíče API vlastní klíč a dejte mu jen oblasti, které integrace čte nebo zapisuje.

• Stiskněte Vytvořit klíč, klíč pojmenujte, vyberte jeho Vypršení a nastavte Přístup: Plný přístup, nebo Omezený přístup s každou oblastí na úrovni Čtení nebo Zápis. Celý klíč se zobrazí jen jednou.
• Tabulka u každého klíče ukazuje Označení, čas Vytvořeno, Přístup a Vypršení.
• Klíč měňte z nabídky na jeho řádku: Upravit přístup, Duplikovat pro výměnu tajemství, nebo Vymazat. Smazaný klíč okamžitě přestane ověřovat a smazání nelze vrátit zpět.
• Volání provedená klíčem API se v Protokolu aktivit přiřadí k tomuto klíči (aktér se zobrazí jako API: <název>).

Klíč dosáhne jen na oblasti, které uvádí jeho přístup. Žádný klíč, ani s Plný přístup, nespravuje uživatele, role, klíče API, zabezpečení přihlášení ani fakturaci. Klíče uchovávejte jako tajemství a nikdy je neukládejte do zdrojového kódu. Článek Klíče API popisuje každou oblast, kterou klíč může dostat, odpověď 403, kterou klíč dostane, když mu oblast chybí, a limity požadavků.

​

Webhooky

Webhooky odesílají události z TWICE do vašich systémů téměř v reálném čase. Každý webhook má tyto vlastnosti: Webhook naslouchá právě jednomu typu události a platí pro celý účet. Pro každou událost, kterou chcete přijímat, vytvořte jeden webhook. TWICE dnes odesílá události životního cyklu objednávky: order.created, order.updated a order.deleted. Formát payloadu najdete v článku Webhooky.

​

Tok integračních dat

Příchozí požadavky se ověřují klíčem API, odchozí události proudí přes webhooky. ID obchodníka omezuje obě strany na váš účet.

​

Související články