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

# Analitika

> Beolvasási statisztikák egy QR-kódhoz vagy a teljes munkaterülethez.

> [!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.

Kérjen le beolvasási összesítéseket és lebontásokat ország, eszköz, böngésző és más szempontok szerint, egyetlen QR-kódhoz vagy a teljes munkaterülethez.

| Metódus | Útvonal | Leírás |
| - | - | - |
| `GET` | `/api/v1/qrs/{qrId}/analytics` | [Egy QR-kód analitikájának lekérése](#egy-qr-kód-analitikájának-lekérése) |
| `GET` | `/api/v1/analytics` | [A munkaterület analitikájának lekérése](#a-munkaterület-analitikájának-lekérése) |

Ha QR-kódonként kész összefoglalóra van szüksége, lásd: [Jelentések](https://docs.getqr.com/hu/api/endpoints/reports.md).

## Mit jelentenek a számok

* **Beolvasások.** Minden szám a `clicks` mezőben szerepel. Egy beolvasás akkor számít, amikor valaki megnyitja a QR-kód rövid linkjét.
* **Egyedi beolvasások.** `unique=true` esetén minden látogató egyszer számít a dátumtartományon belül.
* **Hatókör.** A számok a QR-kód rövid linkjéből származnak. Egy rövid link nélküli QR-kódnál nincs megszámolható beolvasás.
* **Előzmények.** Az analitikai adatok nem állíthatók vissza az API-n keresztül. Egy QR-kód törlése nem törli a korábbi beolvasási adatait.

## Fejlécek

**Authorization** `string` *required*

`Bearer`, majd az API-kulcsa. Lásd: [Hitelesítés](https://docs.getqr.com/hu/api/authentication.md).

## Lekérdezési paraméterek

Mindkét végpont ezeket a paramétereket fogadja. Mindegyik opcionális.

**groupBy** `string` (default: count)

A lebontás dimenziója. A `count` az összesítést adja vissza. Az összes értéket és a válaszok felépítését lásd: [Lebontások](#lebontások).

**interval** `string` (default: 30d)

Előre beállított dátumtartomány: `24h`, `7d`, `30d`, `90d`, `1y`, `mtd`, `qtd`, `ytd` vagy `all`. Lásd: [Dátumtartományok](#dátumtartományok). A `start` megadásakor figyelmen kívül marad.

**start** `string`

Egyéni tartomány kezdete, ISO 8601, például `2026-08-01` vagy `2026-08-01T00:00:00Z`. Elsőbbséget élvez az `interval` paraméterrel szemben. Korábbinak kell lennie, mint az `end`.

**end** `string`

Egyéni tartomány vége, ISO 8601. Alapértelmezés: a mai nap vége. A `start` paraméterrel vagy az `interval=all` értékkel együtt használatos, a többi intervallumnál figyelmen kívül marad.

**timezone** `string` (default: UTC)

IANA időzóna a `timeseries` időegységeinek igazításához, például `America/New_York`. Ismeretlen időzóna esetén `422` a válasz.

**unique** `boolean` (default: false)

`true` esetén az összes beolvasás helyett az egyedi beolvasásokat számolja.

[Dimenziószűrőket](#dimenziószűrők) is küldhet.

## Dátumtartományok

| `interval` | Lefedett időszak | `timeseries` időegységek |
| - | - | - |
| `24h` | Az elmúlt 24 óra | Órák |
| `7d` | Az elmúlt 7 nap, a mai nappal együtt | Napok |
| `30d` | Az elmúlt 30 nap, a mai nappal együtt | Napok |
| `90d` | Az elmúlt 90 nap, a mai nappal együtt | Napok |
| `1y` | Az elmúlt 365 nap, a mai nappal együtt | Hónapok |
| `mtd` | A hónap eleje óta | Napok |
| `qtd` | A negyedév eleje óta | Napok |
| `ytd` | Az év eleje óta | Napok, 180 nap felett hónapok |
| `all` | A munkaterület létrehozása óta | Napok, 180 nap felett hónapok |

Egyéni tartományhoz küldje el a `start` és opcionálisan az `end` paramétert. A legfeljebb 2 napos tartományok óránkénti, a 180 napnál hosszabbak havi, minden köztes tartomány napi időegységeket használ.

## Dimenziószűrők

Szűkítse az eredményeket a szűrőnek megfelelő beolvasásokra. A különböző szűrők AND kapcsolatban állnak. Ha egy szűrő több értéket is elfogad, vesszővel válassza el őket: az értékek OR kapcsolatban állnak.

| Szűrő | Érték | Több érték |
| - | - | - |
| `country` | ISO 3166-1 alpha-2 országkód, például `US` | Igen |
| `region` | ISO 3166-2 régiókód, például `US-CA` | Igen |
| `city` | Városnév, például `New York` | Igen |
| `continent` | `AF`, `AN`, `AS`, `EU`, `NA`, `OC` vagy `SA` | Igen |
| `device` | Eszköztípus, például `Mobile` vagy `Desktop` | Igen |
| `browser` | Böngésző neve, például `Chrome` | Igen |
| `os` | Operációs rendszer, például `iOS` vagy `Windows` | Igen |
| `url` | Cél-URL | Igen |
| `referer` | Hivatkozó, például `google.com` | Nem |
| `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content` | UTM-érték, legfeljebb 190 karakter | Nem |

Ismeretlen ország- vagy kontinenskód esetén `422` a válasz. Az eszköz-, böngésző- és operációsrendszer-neveket a rendszer nagy kezdőbetűvel illeszti, így a `mobile` ugyanúgy működik, mint a `Mobile`.

Például az Egyesült Államokból vagy Kanadából, mobileszközökről érkező beolvasások: `?country=US,CA&device=Mobile`.

## Lebontások

A `count` egy objektumot ad vissza. Minden más érték egy tömböt, `clicks` szerint csökkenő sorrendben (a `timeseries` idő szerint rendezett).

| `groupBy` | Az elemek tartalma |
| - | - |
| `count` | `clicks` (objektum, nem tömb) |
| `timeseries` | `start` (az időegység kezdete), `clicks` |
| `continents` | `continent`, `clicks` |
| `regions` | `region`, `country`, `clicks` |
| `countries` | `country`, `city` (mindig `*`), `clicks` |
| `cities` | `city`, `country`, `clicks` |
| `devices` | `device`, `clicks` |
| `browsers` | `browser`, `clicks` |
| `os` | `os`, `clicks` |
| `triggers` | `trigger` (`qr` vagy `link`), `clicks` |
| `referers` | `referer` (ismeretlen esetén `(direct)`), `clicks` |
| `referer_urls` | `refererUrl` (ismeretlen esetén `(direct)`), `clicks` |
| `top_links` | `id`, `domain`, `key`, `shortLink`, `url`, `createdAt`, `qr` (`id`, `qrType`, `title`), `clicks` |
| `top_urls` | `url`, `clicks` |
| `top_types` | `qr_type`, `clicks` |
| `utm_sources`, `utm_mediums`, `utm_campaigns`, `utm_terms`, `utm_contents` | Az UTM-érték (`utm_source`, `utm_medium`, `utm_campaign`, `utm_term` vagy `utm_content`), `clicks` |

Ismeretlen `groupBy` esetén `422` a válasz, az érvényes értékek listájával.

Válasz, amikor `groupBy=count`:

```json theme={null}
{ "clicks": 142 }
```

Válasz, amikor `groupBy=countries`:

```json theme={null}
[
  { "country": "US", "city": "*", "clicks": 87 },
  { "country": "DE", "city": "*", "clicks": 31 },
  { "country": "GB", "city": "*", "clicks": 24 }
]
```

## Egy QR-kód analitikájának lekérése

`GET /api/v1/qrs/{qrId}/analytics`

Egy QR-kód beolvasási statisztikáit adja vissza, a rövid linkjére szűkítve. A fenti [lekérdezési paramétereket](#lekérdezési-paraméterek) és [dimenziószűrőket](#dimenziószűrők) fogadja.

**qrId** `string` *required*

A QR-kód azonosítója. A [QR-kódok](https://docs.getqr.com/hu/api/endpoints/qr-codes.md) listájának vagy létrehozásának válaszából veheti.

```bash Total scans, last 30 days theme={null}
curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```bash Unique scans theme={null}
curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d&unique=true" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```bash By country, last 7 days theme={null}
curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=countries&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```json 200 theme={null}
{
  "clicks": 142
}
```

## A munkaterület analitikájának lekérése

`GET /api/v1/analytics`

A munkaterület összes QR-kódjának beolvasási statisztikáit adja vissza. A fenti [lekérdezési paramétereket](#lekérdezési-paraméterek) és [dimenziószűrőket](#dimenziószűrők) fogadja, valamint ezeket a szűkítő paramétereket.

**domain** `string`

A `key` paraméterrel együtt az eredményeket az ezzel a domainnel rendelkező rövid linkre szűkíti, például `getqr.sh`. A domainnek a munkaterülethez kell tartoznia.

**key** `string`

A rövid link azonosítója, például `x7Kd2p1`. A `domain` paraméterrel együtt használja. Mindkettő megtalálható a [QR-kód objektumban](https://docs.getqr.com/hu/api/endpoints/qr-codes.md).

**qrType** `string`

A figyelembe veendő QR-kód-típusok, vesszővel elválasztva: `website`, `pdf`, `image`, `video`, `whatsapp`, `social`, `wifi`, `app`, `feedback`, `vcard`, `sms`, `payment`, `location`, `multilink`, `email` vagy `event`. Lásd: [QR-típusok](https://docs.getqr.com/hu/api/guides/qr-types.md).

```bash Devices, last 7 days theme={null}
curl "https://getqr.com/api/v1/analytics?groupBy=devices&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```bash Devices, website QR codes only theme={null}
curl "https://getqr.com/api/v1/analytics?groupBy=devices&interval=30d&qrType=website" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```bash One short link theme={null}
curl "https://getqr.com/api/v1/analytics?groupBy=count&domain=getqr.sh&key=x7Kd2p1" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```json 200 theme={null}
[
  { "device": "Mobile", "clicks": 980 },
  { "device": "Desktop", "clicks": 240 }
]
```

## Gyakori problémák

> [accordion] 400 "QR has no associated link."
>
> A QR-kódnak nincs rövid linkje, így nincs megszámolható beolvasás.

> [accordion] 404-es hiba domain és key szerinti szűréskor
>
> A munkaterületen nincs ilyen domainnel és azonosítóval rendelkező rövid link. Másolja ki a `domain` és a `key` értékét a QR-kód objektumból.

> [accordion] 422-es hiba a groupBy, az interval vagy egy szűrő miatt
>
> Az érték nem támogatott. A hibaüzenet megnevezi a paramétert, és felsorolja az érvényes értékeket.

> [accordion] A számok nem egyeznek az irányítópulttal
>
> Ellenőrizze, hogy ugyanazt a dátumtartományt és időzónát használja-e, és hogy egyedi (`unique=true`) vagy összes beolvasást számol-e.

## Következő lépések

> [card] [Jelentések](https://docs.getqr.com/hu/api/endpoints/reports.md)

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

> [card] [Analitika az alkalmazásban](https://docs.getqr.com/hu/analytics/overview.md)

> [card] [Kéréskorlátok](https://docs.getqr.com/hu/api/rate-limits.md)


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