> ## Documentation Index
> Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrace

> Propojte TWICE s externími systémy pomocí klíčů API, webhooků a identifikátoru vašeho účtu.

![Nastavení integrací v administraci](https://mintcdn.com/twicecommerce/lZhc_tO8u1u_bL0Q/images/settings-integrations.webp?fit=max\&auto=format\&n=lZhc_tO8u1u_bL0Q\&q=85\&s=40fdc769db7318c16cae719abf0e7dd0)

Nastavení > Integrace & API

## Definice

<Snippet file="definitions/cs/integrations-definition.mdx" />

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í

| Funkce | Typ | K čemu slouží |
| :- | :- | :- |
| **ID účtů** | Identita | Zobrazuje ID vašeho obchodníka (tenanta). Externí systémy podle něj přiřadí volání API a payloady webhooků k vašemu účtu |
| **Klíče API** | Ověřování | Vytvářejte klíče pro Admin API TWICE a omezte, co každý z nich může číst nebo zapisovat |
| **Webhooky** | Odchozí události | Nasměrujte HTTPS endpoint na události objednávek, které TWICE odesílá |

Poskytovatele plateb nastavíte samostatně v [Nastavení → Platby](https://www.twicecommerce.com/docs/cs/settings/payments.md), 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](https://www.twicecommerce.com/docs/cs/concepts/admin/activity-logs.md) 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](https://www.twicecommerce.com/docs/cs/concepts/integrations/api-keys.md) 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:

| Vlastnost | Typ | Popis |
| :- | :- | :- |
| **URL** | HTTPS endpoint | Kam se payload odešle metodou POST |
| **Typ události** | Jeden název události | Jediná událost, která webhook spustí |
| **Stav** | Výčet | Zda je webhook **Aktivní**, nebo **Zakázáno** |

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](https://www.twicecommerce.com/docs/cs/concepts/integrations/webhooks.md).

## Tok integračních dat

```mermaid theme={null}
flowchart LR
    External[External system]
    API[TWICE Admin API]
    Core[TWICE Core]
    Webhook[Webhook]

    External -->|Authenticated with API key| API
    API --> Core
    Core -->|Emits event| Webhook
    Webhook -->|HTTPS POST| External
```

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

> **[Klíče API](https://www.twicecommerce.com/docs/cs/concepts/integrations/api-keys.md)**
>
> Ověřování a volání Admin API

> **[Webhooky](https://www.twicecommerce.com/docs/cs/concepts/integrations/webhooks.md)**
>
> Odebírání událostí

> **[Hromadné vytváření](https://www.twicecommerce.com/docs/cs/concepts/integrations/bulk-creation.md)**
>
> Vytvoření mnoha záznamů jedním voláním


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.