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

# Rychlý start

> Získejte první CSV export z WS API během několika minut

Tato stránka vás provede prvním požadavkem na WS API.

## 1. Získejte autorizační klíč

Ke každému požadavku potřebujete autorizační klíč `key`. Pokud jej nemáte, vyžádejte si ho na [it@primulus.cz](mailto:it@primulus.cz).

<Warning>
  Klíč `key` je citlivý údaj. Nevkládejte ho do veřejných repozitářů ani do klientského kódu v prohlížeči.
</Warning>

## 2. Sestavte URL

Základní adresa je:

```
https://zeptej.se.it/api/csv/v1/
```

K ní připojte cestu endpointu a parametry. Například seznam produktů pro mutaci PRI CZ (`mutation_id=1`):

```
https://zeptej.se.it/api/csv/v1/products?key=VAS_KLIC&mutation_id=1
```

## 3. Zavolejte endpoint

<CodeGroup>
  ```bash curl theme={null}
  curl "https://zeptej.se.it/api/csv/v1/products?key=VAS_KLIC&mutation_id=1"
  ```

  ```bash uložení do souboru theme={null}
  curl "https://zeptej.se.it/api/csv/v1/products?key=VAS_KLIC&mutation_id=1" \
    -o products.csv
  ```

  ```python Python theme={null}
  import requests

  resp = requests.get(
      "https://zeptej.se.it/api/csv/v1/products",
      params={"key": "VAS_KLIC", "mutation_id": "1"},
  )
  resp.raise_for_status()

  with open("products.csv", "wb") as f:
      f.write(resp.content)
  ```
</CodeGroup>

## 4. Zpracujte odpověď

Odpověď je CSV v kódování UTF-8. První řádek obsahuje hlavičky sloupců (anglicky, bez diakritiky), další řádky data.

```csv theme={null}
product_id,mutation_id,default_category,name,code,type,ean,price_without_vat,price_with_vat
12345,1,Doplňky stravy>Vitamíny,Vitamin D3,VD3-1000,Zboží,8590000000001,199,239
```

<Tip>
  Ceny používají **čárku** jako oddělovač desetinných míst a nemají oddělovač tisíců. Podrobnosti najdete v sekci [Konvence exportu](/konvence-exportu).
</Tip>

## Další kroky

<CardGroup cols={2}>
  <Card title="Autentizace" icon="lock" href="/autentizace">
    Detaily o parametru `key`.
  </Card>

  <Card title="Filtrování a stránkování" icon="filter" href="/konvence-exportu">
    Parametry `limit`, `from_index` a filtry podle data.
  </Card>

  <Card title="Číselník mutací" icon="list" href="/ciselniky/mutace">
    Seznam všech `mutation_id`.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/clients">
    Kompletní popis endpointů.
  </Card>
</CardGroup>