> ## 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.

# Autentizace

> Přihlášení k WS API pomocí autorizačního klíče

Každý požadavek na WS API musí obsahovat autorizační klíč v query parametru `key`.

## Parametr `key`

<ParamField query="key" type="string" required>
  Autorizační klíč. Povinný ve **všech** endpointech.
</ParamField>

Klíč připojte jako query parametr k URL:

```bash theme={null}
curl "https://zeptej.se.it/api/csv/v1/clients?key=VAS_KLIC"
```

## Získání klíče

Autorizační klíč vám vydá tým Primulus Group. Napište na [it@primulus.cz](mailto:it@primulus.cz).

## Bezpečnost

<Warning>
  Klíč `key` opravňuje k exportu firemních dat. Chraňte ho jako heslo.
</Warning>

* Klíč nikdy nevkládejte do veřejných repozitářů, logů ani klientského kódu běžícího v prohlížeči.
* Volání provádějte ze serveru, ne z prohlížeče koncového uživatele.
* Klíč ukládejte do proměnných prostředí nebo tajného úložiště (secret manageru).

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

<Info>
  Osobní údaje jsou v exportech anonymizované — e-mail a telefon jsou vraceny jako otisk SHA-256 (`email_anonymized`, `phone_anonymized`).
</Info>