# Aktivace exportů (/activation)

<Callout title="Pro spravované zákazníky">
Tato stránka platí pro projekty, které spravuje DeepScout. V self-service projektu jsou exporty zapnuté vždy. Viz [Stažení exportů](/api/exports.md).
</Callout>

## Aktivace [#aktivace]

Exporty se zapínají v aplikaci v sekci [Nastavení → Exporty](https://reports.deepscout.cz/nastaveni). Stačí kliknout na **Zapnout exporty** a vybrat formát (JSON nebo XML). Po aktivaci se automaticky vygenerují všechny výchozí datasety — může to trvat přibližně 15 minut.

{/* TODO: přidat screenshoty z Reports UI */}

## API klíč [#api-klíč]

Pro přístup k exportům potřebujete API klíč, který najdete v sekci [Nastavení → API](https://reports.deepscout.cz/nastaveni).

## Přístup k datům [#přístup-k-datům]

Po aktivaci jsou data dostupná na adrese níže. API klíč posílejte v hlavičce `Authorization`. Odpověď přesměruje na dočasnou adresu souboru, proto v `curl` použijte `-L`.

```
GET https://api.deepscout.ai/v1/exports/{dataset}
Authorization: Bearer VÁŠ_API_KLÍČ
```

```bash
curl -L https://api.deepscout.ai/v1/exports/all_products_with_details \
  -H "Authorization: Bearer VÁŠ_API_KLÍČ" \
  -o all_products_with_details.jsonl.gz
```

Starší parametr `?token=VÁŠ_API_KLÍČ` stále funguje, ale je zastaralý.

## Aktualizace dat [#aktualizace-dat]

Exporty aktualizujeme po každém zpracování dat, obvykle každých 8 hodin. API vždy vrátí poslední soubor.

## Chyby [#chyby]

| Kód | Význam |
|---|---|
| `401` | Neplatný API klíč. |
| `403` | Exporty nejsou zapnuté, nebo je projekt zastavený. |
| `404` | Dataset není v projektu zapnutý, nebo soubor ještě není připravený. |
| `503` | Údržba. Zkuste to později. |

## Formáty [#formáty]

| Formát | Popis |
|---|---|
| **JSON** | JSONL — jeden JSON objekt na řádek. Výchozí formát. |
| **XML** | XML feed. |