# Úvod k API v2

**Zaslat API v2** je nová generace veřejného API, která vzniká postupně vedle
[API v1](/api/v1/content). Zatím pokrývá práci s košíkem rozpracovaných zásilek (**OmniCart**)
a rušení objednávek svozu; další oblasti budou přibývat.

:::info

Kompletní referenci endpointů, parametrů a datových schémat najdete v
[API Referenci](/api-v2).

Kompletní OpenAPI specifikaci si můžete
[stáhnout ve formátu YAML](/api-v2/2.0.0/schema.yaml) — hodí se pro import do nástrojů
(Postman, Insomnia) i jako podklad pro AI agenty a generátory klientů.

:::

## Košík (OmniCart)

Košík obsahuje rozpracované zásilky — připravené, ale dosud závazně neobjednané. Endpoint
`cart/create` založí v košíku koncept zásilky se zadanou trasou, balíky a doplňkovými
službami; nic se v tu chvíli neobjednává ani neúčtuje. Odpověď vrací kromě identifikátoru
konceptu i dostupné nabídky přepravy (`rates`), případně seznam nedostatků v datech (`errors`).
Zásilky z košíku pak zkontrolujete, opravíte a závazně objednáte v
[Manažeru zásilek](/mz/zasilky).

Stejný princip košíku využívají [e-shopové integrace](/integrations/full_integration) a
[MCP server](/mcp/mcp_documentation) — API v2 je cesta, jak košík plnit z vlastního systému.

## Rušení svozů

Endpoint `collection-request/cancel` zruší objednaný svoz u daného dopravce pro zadané datum.

## Autentizace

Všechny požadavky je nutné posílat s autentizačním HTTP headerem `x-apikey` — stejně jako u
API v1. API klíč najdete po přihlášení do Manažeru zásilek
([app.zaslat.cz](https://app.zaslat.cz)) v sekci **Nastavení → Integrace**, část
_Napojení pomocí API_.

## Vztah k API v1

[API v1](/api/v1/content) zůstává v provozu beze změn — nadále slouží k získávání nabídek
přepravy, závaznému objednávání zásilek, sledování a správě adresáře. API v2 jej doplňuje o
scénář „připravit teď, objednat později": zásilky vložené do košíku přes API v2 dokončíte
hromadně v Manažeru zásilek.