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

# Ověřování

> Vytvořte API klíč a ověřujte své požadavky.

> [!NOTE]
>
> GetQR API je v beta verzi a je dostupné pro vybrané pracovní prostory. Do obecného vydání se podrobnosti mohou změnit.

GetQR API ověřuje každý požadavek API klíčem vašeho účtu. Každý uživatel má jeden klíč, který v jednom pracovním prostoru jedná vaším jménem.

## Než začnete

* Jste vlastník pracovního prostoru nebo editor. Čtenáři API klíč vytvořit ani používat nemohou.
* Vlastník pracovního prostoru má aktivní předplatné.

## Vytvoření API klíče

**1. Otevřete nastavení účtu**

Otevřete nastavení účtu a přejděte do sekce **API**.

**2. Vygenerujte klíč**

Klikněte na **Generate API key**.

**3. Zkopírujte klíč**

Zobrazte klíč a zkopírujte ho. Klíče začínají na `sk_live_`.

Klíč můžete kdykoli znovu zobrazit a zkopírovat. V nastavení uvidíte také, kdy byl klíč vytvořen a kdy byl naposledy použit.

## Ověřování požadavků

Klíč posílejte jako Bearer token v hlavičce `Authorization` každého požadavku:

```bash theme={null}
curl "https://getqr.com/api/v1/qrs" \
  -H "Authorization: Bearer sk_live_..."
```

| Problém | Odpověď |
| - | - |
| Chybí hlavička `Authorization` | `401 unauthorized`: „Missing Authorization header.“ |
| Hlavička nezačíná na `Bearer ` | `400 bad_request`: „Misconfigured authorization header. Did you forget to add 'Bearer '?“ |
| Neznámý nebo přegenerovaný klíč | `401 unauthorized`: „Unauthorized: Invalid API key.“ |
| Vaše role je čtenář | `403 forbidden`: „API access is not available for this role.“ |
| Předplatné vlastníka pracovního prostoru není aktivní | `403 forbidden`: „Access denied: This account does not have an active subscription.“ |
| API není pro váš pracovní prostor zapnuté | `404 not_found`: „This endpoint is not available.“ |

[Kontrola stavu](https://docs.getqr.com/cs/api/endpoints/health.md) je jediný endpoint, který funguje bez klíče.

## Přístup a role

* **Role.** Vytvářet a používat API klíč mohou jen vlastník pracovního prostoru a editoři. Čtenáři to nemohou.
* **Pracovní prostor.** Každý klíč patří k jedinému pracovnímu prostoru a všechny požadavky se provádějí v něm. ID pracovního prostoru není třeba předávat.
* **Průběžná kontrola.** Přístup se ověřuje při každém požadavku podle vaší aktuální role a předplatného vlastníka pracovního prostoru. Vaše vlastní předplatné nehraje roli. Pokud se vaše role změní na čtenáře nebo předplatné vlastníka skončí, požadavky vracejí `403`, dokud nebude přístup obnoven. Nový klíč nepotřebujete.
* **Odebrání.** Pokud vás z pracovního prostoru odeberou, váš API klíč se smaže. Pokud vás znovu přidají, vygenerujte si nový klíč.

## Přegenerování klíče

Klíč přegenerujte, pokud unikne nebo k němu získá přístup někdo, kdo ho mít nemá.

> [!WARNING]
>
> Váš současný klíč okamžitě přestane fungovat. Všechny aplikace a integrace, které ho používají, přestanou fungovat, dokud je neaktualizujete novým klíčem.

**1. Klikněte na Regenerate**

V nastavení účtu přejděte do sekce **API** a klikněte na **Regenerate**.

**2. Potvrďte**

Klikněte na **Regenerate key**.

**3. Aktualizujte své aplikace**

Zkopírujte nový klíč a nahraďte jím starý všude, kde ho používáte.

## Ochrana klíče

Zacházejte s klíčem jako s heslem: kdokoli, kdo ho má, může ve vašem pracovním prostoru vytvářet, měnit a mazat QR kódy.

* Uložte ho do proměnné prostředí nebo do správce tajných údajů, ne do zdrojového kódu.
* Volejte API jen ze svého serveru. Nikdy klíč nevkládejte do webu, mobilní aplikace ani ničeho jiného, co si uživatelé mohou prohlédnout.
* Sdílejte ho jen s vývojáři, kteří ho potřebují.
* Jakmile máte podezření, že unikl, přegenerujte ho.

## Časté problémy

> [accordion] Dostávám 401 s klíčem, který dříve fungoval
>
> Klíč byl přegenerován, nebo vás z pracovního prostoru odebrali a klíč byl smazán. Zkopírujte aktuální klíč z nastavení účtu nebo vygenerujte nový.

> [accordion] Na každý požadavek dostávám 403
>
> Ověřte, že máte roli vlastníka nebo editora a že je předplatné vlastníka pracovního prostoru aktivní. Jakmile bude přístup obnoven, klíč začne znovu fungovat.

> [accordion] Dostávám 404 "This endpoint is not available."
>
> API je v beta verzi a pro váš pracovní prostor zatím není zapnuté.

> [accordion] Nastavení API nevidím
>
> Zobrazuje se jen vlastníkovi pracovního prostoru a editorům, a to jen v pracovních prostorech, kde je API zapnuté.

## Co dál

> [card] [Úvod do API](https://docs.getqr.com/cs/api/introduction.md)

> [card] [Chyby](https://docs.getqr.com/cs/api/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.