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

# WS API v1

> Exportní API skupiny Primulus Group pro data z e-shopů

WS API poskytuje **read-only exporty** dat z e-shopů skupiny Primulus Group ve formátu **CSV**. Umožňuje stahovat zákazníky, objednávky, pravidelné objednávky, faktury, výdejky, produkty a statistiky marží napříč jednotlivými mutacemi (satelity).

<Info>
  Všechny endpointy vracejí `text/csv`, nikoli JSON. Autorizace probíhá přes povinný query parametr `key`.
</Info>

## Základní informace

<CardGroup cols={2}>
  <Card title="Host" icon="server">
    `https://zeptej.se.it/api/csv/v1/`
  </Card>

  <Card title="Formát" icon="file-csv">
    CSV (`text/csv`), kódování UTF-8
  </Card>

  <Card title="Metoda" icon="download">
    Všechny endpointy jsou `GET`
  </Card>

  <Card title="Autorizace" icon="key">
    Query parametr `key` v každém požadavku
  </Card>
</CardGroup>

## Kudy dál

<CardGroup cols={2}>
  <Card title="Rychlý start" icon="rocket" href="/quickstart">
    První požadavek na API za pár minut.
  </Card>

  <Card title="Autentizace" icon="lock" href="/autentizace">
    Jak se přihlásit pomocí klíče `key`.
  </Card>

  <Card title="Konvence exportu" icon="table-list" href="/konvence-exportu">
    Formáty cen, datumů, booleanů a pravidla verzování.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/clients">
    Všech 8 endpointů s popisem sloupců a parametrů.
  </Card>
</CardGroup>

## Přehled endpointů

| Endpoint                                                      | Cesta                    | Popis                                  |
| ------------------------------------------------------------- | ------------------------ | -------------------------------------- |
| [Clients](/api-reference/clients)                             | `/clients`               | Export zákazníků                       |
| [Orders](/api-reference/orders)                               | `/order-items`           | Objednávky a jejich položky            |
| [Regular Orders](/api-reference/regular-orders)               | `/regular-order-items`   | Pravidelné objednávky a položky        |
| [Regular Order History](/api-reference/regular-order-history) | `/regular-order-history` | Historie stavů pravidelných objednávek |
| [Invoices](/api-reference/invoices)                           | `/invoice-items`         | Faktury a jejich položky               |
| [Issues](/api-reference/issues)                               | `/issue-items`           | Výdejky a jejich položky               |
| [Products](/api-reference/products)                           | `/products`              | Katalog produktů                       |
| [Margin](/api-reference/margin)                               | `/statistics/margin`     | Statistiky prodejnosti a marží         |