# Úvod k API v1

**Zaslat API v1** slouží k získávání nabídek přepravy, vytváření a správě zásilek, žádostem o
svoz, čtení číselníku podacích/výdejních míst a správě adresáře kontaktů.

:::info

Kompletní referenci endpointů, parametrů a datových schémat najdete v
[API Referenci](/api-v1). Tato sekce doplňuje kontext a rozšíření, která se do referenční
dokumentace nehodí.

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

:::

## Autentizace

Všechny požadavky je nutné posílat s autentizačním HTTP headerem `x-apikey`. Produkční API klíč
najdete ve správním rozhraní ([app.zaslat.cz](https://app.zaslat.cz)) v sekci **API** (Nastavení
uživatele).

## Testovací prostředí

Pro vývoj a ladění integrace je k dispozici oddělené testovací prostředí na adrese
`https://test.zaslat.cz/api/v1`. Testovací API klíč získáte stejným postupem v testovacím
správním rozhraní na [app-test.zaslat.cz](https://app-test.zaslat.cz) — účty a data jsou od
produkce zcela oddělené.

## Obsah sekce

- [API Reference](/api-v1) — kompletní přehled endpointů, parametrů a datových schémat.
- [Objednávka celní zásilky](/api/v1/customs_shipment_order) — rozšíření endpointu pro vytvoření
  zásilky o objekt `customs` potřebný pro celní řízení.
- [Objednávka ze svozové adresy](/api/v1/order_from_pickup_address) — objednávka zásilek ze
  svozové adresy s vlastním tiskem štítků (typ `OCCASIONAL`).
- [Dobírka (COD)](/api/v1/cod) — pravidla dobírky: povolené směry a měny, bankovní účet,
  minimální částky a omezení dopravců.
- [Doručení na výdejní místo](/api/v1/parcel_points) — objednávka s podáním nebo doručením na
  výdejní místo (parcel shop / box).
- [Sledování zásilek a stavy](/api/v1/tracking) — životní cyklus zásilky a doporučený způsob
  sledování stavu.
- [Mapový widget](/map_widget) — interaktivní mapa podacích a výdejních míst pro vložení
  do vašeho webu, kterou si můžete přímo vyzkoušet.
- [Příklady implementace](/api/v1/implementation_examples) — ukázky volání API v jazyce PHP.