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

# Hitelesítés

> API-kulcs létrehozása és a kérések hitelesítése.

> [!NOTE]
>
> A GetQR API béta állapotban van, és csak kiválasztott munkaterületek számára érhető el. A részletek az általános kiadásig változhatnak.

A GetQR API minden kérést a fiókja API-kulcsával hitelesít. Minden felhasználónak egy kulcsa van, amely egy munkaterületen az Ön nevében jár el.

## Mielőtt elkezdené

* Ön a munkaterület tulajdonosa vagy szerkesztője. A megtekintők nem hozhatnak létre és nem használhatnak API-kulcsot.
* A munkaterület tulajdonosának aktív előfizetése van.

## API-kulcs létrehozása

**1. Nyissa meg a fiókbeállításokat**

Nyissa meg a fiókbeállításokat, és lépjen az **API** részre.

**2. Generálja a kulcsot**

Kattintson a **Generate API key** gombra.

**3. Másolja ki a kulcsot**

Jelenítse meg a kulcsot, és másolja ki. A kulcsok `sk_live_` előtaggal kezdődnek.

A kulcsot bármikor újra megjelenítheti és kimásolhatja. A beállításokban azt is látja, mikor jött létre a kulcs, és mikor használták utoljára.

## Kérések hitelesítése

Minden kérésben küldje el a kulcsot Bearer tokenként az `Authorization` fejlécben:

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

| Probléma | Válasz |
| - | - |
| Nincs `Authorization` fejléc | `401 unauthorized`: „Missing Authorization header.” |
| A fejléc nem `Bearer ` előtaggal kezdődik | `400 bad_request`: „Misconfigured authorization header. Did you forget to add 'Bearer '?” |
| Ismeretlen vagy újragenerált kulcs | `401 unauthorized`: „Unauthorized: Invalid API key.” |
| Az Ön szerepköre megtekintő | `403 forbidden`: „API access is not available for this role.” |
| A munkaterület tulajdonosának előfizetése nem aktív | `403 forbidden`: „Access denied: This account does not have an active subscription.” |
| Az API nincs engedélyezve a munkaterületén | `404 not_found`: „This endpoint is not available.” |

Az [állapotellenőrzés](https://docs.getqr.com/hu/api/endpoints/health.md) az egyetlen végpont, amely kulcs nélkül is működik.

## Hozzáférés és szerepkörök

* **Szerepkörök.** API-kulcsot csak a munkaterület tulajdonosa és a szerkesztők hozhatnak létre és használhatnak. A megtekintők nem.
* **Munkaterület.** Minden kulcs egyetlen munkaterülethez tartozik, és minden kérés abban a munkaterületben fut. Munkaterület-azonosítót nem kell megadnia.
* **Folyamatos ellenőrzés.** A rendszer minden kérésnél ellenőrzi a hozzáférést az Ön aktuális szerepköre és a munkaterület tulajdonosának előfizetése alapján. A saját előfizetése nem számít. Ha a szerepköre megtekintőre változik, vagy a tulajdonos előfizetése lejár, a kérések `403` választ adnak, amíg a hozzáférés helyre nem áll. Új kulcsra nincs szükség.
* **Eltávolítás.** Ha eltávolítják a munkaterületről, az API-kulcsa törlődik. Ha újra hozzáadják, generáljon új kulcsot.

## A kulcs újragenerálása

Generálja újra a kulcsot, ha kiszivárgott, vagy illetéktelen személy fért hozzá.

> [!WARNING]
>
> A jelenlegi kulcs azonnal megszűnik működni. Minden alkalmazás vagy integráció, amely használja, addig nem működik, amíg az új kulccsal nem frissíti.

**1. Kattintson a Regenerate gombra**

A fiókbeállításokban lépjen az **API** részre, és kattintson a **Regenerate** gombra.

**2. Erősítse meg**

Kattintson a **Regenerate key** gombra.

**3. Frissítse az alkalmazásait**

Másolja ki az új kulcsot, és cserélje le vele a régit mindenhol, ahol használja.

## A kulcs biztonsága

Kezelje a kulcsot úgy, mint egy jelszót: aki birtokolja, QR-kódokat hozhat létre, módosíthat és törölhet a munkaterületén.

* Környezeti változóban vagy titokkezelőben tárolja, ne a forráskódban.
* Az API-t csak a saját szerveréről hívja. Soha ne tegye a kulcsot weboldalba, mobilalkalmazásba vagy bármibe, amit a felhasználók megvizsgálhatnak.
* Csak azokkal a fejlesztőkkel ossza meg, akiknek szükségük van rá.
* Generálja újra, amint felmerül a gyanú, hogy kiszivárgott.

## Gyakori problémák

> [accordion] 401-es hibát kapok egy korábban működő kulccsal
>
> A kulcsot újragenerálták, vagy eltávolították Önt a munkaterületről, és a kulcs törlődött. Másolja ki az aktuális kulcsot a fiókbeállításokból, vagy generáljon újat.

> [accordion] Minden kérésre 403-as hibát kapok
>
> Ellenőrizze, hogy a szerepköre tulajdonos vagy szerkesztő-e, és hogy a munkaterület tulajdonosának előfizetése aktív-e. A kulcs a hozzáférés helyreállása után azonnal újra működik.

> [accordion] 404-es hiba: „This endpoint is not available.”
>
> Az API béta állapotban van, és a munkaterületén még nincs engedélyezve.

> [accordion] Nem látom az API-beállításokat
>
> Csak a munkaterület tulajdonosa és a szerkesztők látják őket, és csak azokban a munkaterületekben, ahol az API engedélyezve van.

## Következő lépések

> [card] [Bevezetés az API-ba](https://docs.getqr.com/hu/api/introduction.md)

> [card] [Hibák](https://docs.getqr.com/hu/api/errors.md)


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