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

# Bevezetés az API-ba

> Kezelje QR-kódjait, sablonjait, analitikáját és jelentéseit saját kódjából.

> [!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 egy REST API mindarra, amit az irányítópulton végez: QR-kódok létrehozására és frissítésére, képeik letöltésére, a beolvasási analitika lekérésére és jelentések exportálására. Hitelesítsen a fiókja API-kulcsával, és hívja a `/api/v1` alatti, verziózott végpontokat.

## Mire használható

> [card] [QR-kódok](https://docs.getqr.com/hu/api/endpoints/qr-codes.md)
>
> QR-kódok létrehozása, listázása, frissítése, szüneteltetése, másolása, törlése és letöltése.

> [card] [Analitika](https://docs.getqr.com/hu/api/endpoints/analytics.md)
>
> Beolvasási összesítések és lebontások egy QR-kódhoz vagy a teljes munkaterülethez.

> [card] [Jelentések](https://docs.getqr.com/hu/api/endpoints/reports.md)
>
> Egyszeri jelentés exportálása vagy rendszeres jelentés-e-mailek ütemezése.

> [card] [Sablonok](https://docs.getqr.com/hu/api/endpoints/templates.md)
>
> Dizájnok mentése és alkalmazása új QR-kódokra.

> [card] [Tömeges QR-létrehozás](https://docs.getqr.com/hu/api/endpoints/bulk-qr-creations.md)
>
> Akár 100 QR-kód létrehozása egyszerre JSON-ból vagy CSV-fájlból.

> [card] [Fájlok](https://docs.getqr.com/hu/api/endpoints/files.md)
>
> PDF-ek, képek, videók és logók feltöltése a QR-kódokhoz.

> [card] [Állapot](https://docs.getqr.com/hu/api/endpoints/health.md)
>
> Annak ellenőrzése, hogy az API működik-e. Nem kell hozzá API-kulcs.

## Útmutatók

> [card] [QR-típusok](https://docs.getqr.com/hu/api/guides/qr-types.md)
>
> Az adatformátum mind a 16 QR-típushoz.

> [card] [Testreszabás](https://docs.getqr.com/hu/api/guides/customization.md)
>
> Pontstílusok, sarkok, színek, keretek és logók.

> [card] [Hozzáférési szabályok](https://docs.getqr.com/hu/api/guides/access-rules.md)
>
> Ütemezés, beolvasási korlát, jelszó, szüneteltetés és törlés.

## Alap-URL

Minden végpont egyetlen alap-URL alatt található:

```text theme={null}
https://getqr.com/api/v1
```

## Verziókezelés

Az API verziója az útvonal része: minden végpont a `/api/v1/` alatt található.

* A nem kompatibilis változások új verzióelőtag alatt jelennek meg, például `/api/v2/`, a `/api/v1/` pedig tovább működik.
* A bővítő változások, például új opcionális mezők vagy új végpontok, a v1-en belül is megjelenhetnek. A kódja hagyja figyelmen kívül azokat a válaszmezőket, amelyeket nem ismer.

## Gyors kezdés

**1. Szerezze be az API-kulcsát**

Generálja vagy jelenítse meg a kulcsát a fiókbeállításokban. Lásd: [Hitelesítés](https://docs.getqr.com/hu/api/authentication.md).

**2. Ellenőrizze, hogy az API elérhető-e**

```bash theme={null}
curl https://getqr.com/api/v1/health
```

A válasz: `{ "status": "ok", "version": "v1" }`.

**3. Hozza létre első QR-kódját**

```bash theme={null}
curl -X POST "https://getqr.com/api/v1/qrs" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: first-qr-0001" \
  -d '{
    "qrType": "website",
    "data": "https://example.com",
    "title": "Landing page"
  }'
```

Az API `201` kóddal válaszol, és visszaadja az új QR-kódot, benne az `id` és a `shortLink` mezővel.

**4. Töltse le a képet**

```bash theme={null}
curl "https://getqr.com/api/v1/qrs/{qrId}/download?format=png&resolution=1024" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  --output qr-code.png
```

## Kérések és válaszok

* **Formátum.** A kéréstörzset JSON-ként küldje, `Content-Type: application/json` fejléccel. Kivétel a [tömeges létrehozás](https://docs.getqr.com/hu/api/endpoints/bulk-qr-creations.md) CSV-feltöltése, amely `multipart/form-data` formátumot használ.
* **Válaszok.** A válaszok JSON formátumúak. A letöltések, például a QR-képek és a tömeges ZIP-archívumok, magát a fájlt adják vissza.
* **Dátumok.** A dátumok ISO 8601 formátumú, UTC szerinti karakterláncok, például `2026-08-01T10:00:00.000Z`.
* **Lekérdezési paraméterek.** A logikai paraméterek a `true` vagy a `false` karakterláncot fogadják.
* **Részleges frissítés.** A `PATCH` végpontok csak az elküldött mezőket módosítják.
* **Titkos adatok.** A válaszok soha nem tartalmaznak jelszavakat vagy belső azonosítókat. Egy jelszóval védett QR-kód csak ennyit jelez: `passwordProtected: true`.
* **Munkaterület.** Minden kérés abban a munkaterületben fut, amelyhez az API-kulcs tartozik. Munkaterület-azonosítót nem kell megadnia. Lásd: [Hozzáférés és szerepkörök](https://docs.getqr.com/hu/api/authentication.md#hozzáférés-és-szerepkörök).
* **Hibák.** A sikertelen kérések egy `error` objektumot adnak vissza, állandó `code` értékkel. Lásd: [Hibák](https://docs.getqr.com/hu/api/errors.md).

## Lapozás

A lista végpontok (QR-kódok, sablonok és ütemezett jelentések) két lekérdezési paramétert fogadnak:

| Paraméter | Leírás |
| - | - |
| `page` | A visszaadandó oldal. Alapértelmezés: `1`. |
| `pageSize` | Találatok oldalanként, legfeljebb `100`. Alapértelmezés: `100`. |

Egy `data` tömbbel és egy `pagination` objektummal válaszolnak:

```json theme={null}
{
  "data": [ … ],
  "pagination": { "page": 1, "pageSize": 50, "total": 128, "hasMore": true }
}
```

| Mező | Leírás |
| - | - |
| `page` | A kapott oldal. |
| `pageSize` | A kapott oldalméret. |
| `total` | A találatok száma az összes oldalon. |
| `hasMore` | `true`, amíg van még további oldal. |

Kérje le a következő oldalt, amíg a `hasMore` értéke `true`. A `100`-nál nagyobb `pageSize` [`422`](https://docs.getqr.com/hu/api/errors#validációs-hibák) hibát ad.

## Idempotencia

Hálózati hiba után nem mindig tudhatja, hogy a kérés célba ért-e. A [QR-kód létrehozása](https://docs.getqr.com/hu/api/endpoints/qr-codes.md#qr-kód-létrehozása) kérés biztonságos megismétléséhez küldjön egy `Idempotency-Key` fejlécet egy Ön által választott egyedi értékkel:

```bash theme={null}
-H "Idempotency-Key: order-4821-qr"
```

* Ha 24 órán belül ugyanazzal a kulccsal ismétli meg a kérést, az eredeti választ kapja vissza, és nem jön létre második QR-kód.
* Az `x-idempotent-replay` válaszfejléc értéke ismételt válasznál `true`, új válasznál `false`.
* Ha az adott kulccsal küldött első kérés még fut, az API `409 conflict` választ ad. Próbálja újra, miután befejeződött.
* Ha egy kulcsot más kéréstörzzsel használ újra, a válasz `422 unprocessable_entity`.
* Fejléc nélkül a 30 másodpercen belül elküldött azonos kéréstörzset a rendszer duplikátumnak tekinti.

A tömeges létrehozás ehelyett egy `idempotencyKey` mezőt vár a kéréstörzsben. Lásd: [Tömeges QR-létrehozás](https://docs.getqr.com/hu/api/endpoints/bulk-qr-creations.md).

## Kéréskorlátok

API-kulcsonként percenként legfeljebb 600 kérés küldhető. Lásd: [Kéréskorlátok](https://docs.getqr.com/hu/api/rate-limits.md).

## Később érkezik

A nyomdakész csomagok egy későbbi kiadásban várhatók.

## Következő lépések

> [card] [Hitelesítés](https://docs.getqr.com/hu/api/authentication.md)

> [card] [QR-kódok](https://docs.getqr.com/hu/api/endpoints/qr-codes.md)


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