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

# Jelentések

> Egyszeri beolvasási jelentés exportálása vagy rendszeres jelentés-e-mailek ütemezé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 jelentések QR-kódonként összegzik a beolvasásokat egy lezárult napra, hétre vagy hónapra. Exportáljon egyet azonnal, vagy ütemezzen egy jelentést, amelyet a rendszer rendszeresen elküld e-mailben.

| Metódus | Útvonal | Leírás |
| - | - | - |
| `POST` | `/api/v1/reports` | [Jelentés exportálása](#jelentés-exportálása) |
| `GET` | `/api/v1/reports/schedules` | [Ütemezett jelentések listázása](#ütemezett-jelentések-listázása) |
| `POST` | `/api/v1/reports/schedules` | [Jelentés ütemezése](#jelentés-ütemezése) |
| `PATCH` | `/api/v1/reports/schedules/{id}` | [Ütemezett jelentés frissítése](#ütemezett-jelentés-frissítése) |
| `DELETE` | `/api/v1/reports/schedules/{id}` | [Ütemezett jelentés törlése](#ütemezett-jelentés-törlése) |

## Fejlécek

**Authorization** `string` *required*

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

**Content-Type** `string`

`application/json`. A `POST` és a `PATCH` kéréseknél kötelező.

## Hatókör

Az egyszeri és az ütemezett jelentések egyaránt egy `scope` értéket várnak:

| `scope` | Lefedi | `qrIds` |
| - | - | - |
| `all` | A munkaterület QR-kódjait | Hagyja el |
| `selected` | A QR-kódok egy kiválasztott körét | Egy vagy több azonosító |
| `single` | Pontosan egy QR-kódot | Pontosan egy azonosító |

Egy jelentés legfeljebb 50 QR-kódot sorol fel. Az `all` esetén ezek a legutóbb létrehozott aktív QR-kódok; a szüneteltetett kódok kimaradnak. A `selected` és a `single` esetén a szüneteltetett kódok is szerepelnek. A rövid link nélküli QR-kódoknak nincs beolvasásuk, ezért kimaradnak.

## Időszak

Az időszak mindig a legutóbbi lezárult időszak, így a jelentés soha nem tartalmazza a mai nap részleges adatait. Határai a jelentés időzónája szerinti éjfélek.

| `period` vagy `frequency` | Lefedi |
| - | - |
| `daily` | Az előző napot |
| `weekly` | Az előző hetet, hétfőtől vasárnapig |
| `monthly` | Az előző naptári hónapot |

## Jelentés exportálása

`POST /api/v1/reports`

Elkészíti a jelentést a legutóbbi lezárult időszakra, és a válaszban adja vissza.

**scope** `string` *required*

`all`, `selected` vagy `single`. Lásd: [Hatókör](#hatókör).

**period** `string` *required*

`daily`, `weekly` vagy `monthly`. Lásd: [Időszak](#időszak).

**format** `string` *required*

A `json` a válasz törzsében adja vissza a jelentést. A `csv` és a `pdf` letölthető fájlt ad vissza.

**qrIds** `string[]`

A lefedendő QR-kódok. Kötelező a `selected` (egy vagy több azonosító) és a `single` (pontosan egy azonosító) esetén. Az `all` esetén hagyja el.

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

IANA időzóna, amelyhez az időszak határai igazodnak, például `America/New_York`. Ismeretlen időzóna esetén `422` a válasz.

**locale** `string` (default: en)

A PDF nyelve, például `en` vagy `de`. Nem támogatott érték esetén angol lesz. A `csv` és a `json` figyelmen kívül hagyja.

**name** `string`

A PDF-en megjelenő cím, legfeljebb 40 karakter. A `csv` és a `json` figyelmen kívül hagyja.

### JSON-válasz

**periodStart** `string`

Az időszak első napja, `YYYY-MM-DD`.

**periodEnd** `string`

Az időszak utáni első nap, `YYYY-MM-DD`. Az időszak ennek a napnak a kezdetén, éjfélkor ér véget.

**qrs** `object[]`

QR-kódonként egy bejegyzés.

**properties**

**qrId** `string`

A QR-kód azonosítója.

**name** `string`

A QR-kód címe, vagy `Untitled QR`.

**type** `string`

A QR-kód típusa, például `website`.

**totalScans** `integer`

Az összes beolvasás az időszakban.

**uniqueScans** `integer`

Az egyedi beolvasások az időszakban.

**topGeography** `string`

A legtöbb beolvasást adó ország kódja, vagy `—`, ha nincs beolvasás.

**topDevice** `string`

A legtöbb beolvasást adó eszköz, vagy `—`.

**topOs** `string`

A legtöbb beolvasást adó operációs rendszer, vagy `—`.

**topBrowser** `string`

A legtöbb beolvasást adó böngésző, vagy `—`.

### CSV- és PDF-válasz

A törzs maga a fájl. A `Content-Disposition` az időszakról nevezi el, például `report-2026-08-10_2026-08-17.csv`. A CSV QR-kódonként egy sort tartalmaz, a következő oszlopokkal: `QR ID`, `QR name`, `QR type`, `Total scans`, `Unique scans`, `Top geography`, `Top device`, `Top OS` és `Top browser`.

```bash JSON theme={null}
curl -X POST "https://getqr.com/api/v1/reports" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "selected",
    "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
    "period": "weekly",
    "format": "json",
    "timezone": "America/New_York"
  }'
```

```bash PDF theme={null}
curl -X POST "https://getqr.com/api/v1/reports" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scope": "all", "period": "monthly", "format": "pdf", "locale": "de" }' \
  --output report.pdf
```

```json 200 theme={null}
{
  "periodStart": "2026-08-10",
  "periodEnd": "2026-08-17",
  "qrs": [
    {
      "qrId": "clw3n7t1x0002ab0d5mqe8pkr",
      "name": "Landing page",
      "type": "website",
      "totalScans": 128,
      "uniqueScans": 96,
      "topGeography": "US",
      "topDevice": "Mobile",
      "topOs": "iOS",
      "topBrowser": "Safari"
    }
  ]
}
```

## Az ütemezett jelentés objektum

Az ütemezett jelentést a rendszer annak a fióknak küldi el e-mailben, amely létrehozta, a jelentés időzónája szerinti éjfélkor.

**id** `string`

Az ütemezett jelentés azonosítója.

**name** `string | null`

Címke, amely az e-mail tárgyában és az irányítópulton jelenik meg.

**frequency** `string`

`daily`, `weekly` vagy `monthly`.

**scope** `string`

`all`, `selected` vagy `single`.

**qrIds** `string[] | null`

A jelentés által lefedett QR-kódok a `selected` és a `single` hatókörnél. `null`, ha nem küldtek azonosítókat.

**filters** `null`

Mindig `null`. Későbbi használatra fenntartva.

**includePdf** `boolean`

Csatol-e a rendszer PDF-et az e-mailhez.

**status** `string`

`active` vagy `paused`.

**timezone** `string`

IANA időzóna, amelyhez a küldés időpontja és az időszak igazodik.

**locale** `string`

Az e-mail és a PDF nyelve.

**nextRunAt** `string`

A következő e-mail esedékessége, ISO 8601: a következő éjfél (`daily`), a következő hétfő (`weekly`) vagy a következő hónap 1. napja (`monthly`), a jelentés időzónája szerint.

**lastRunAt** `string | null`

A legutóbbi e-mail elküldésének időpontja, ISO 8601.

**createdAt** `string`

Létrehozás dátuma, ISO 8601.

**updatedAt** `string`

Utolsó frissítés dátuma, ISO 8601.

## Ütemezett jelentések listázása

`GET /api/v1/reports/schedules`

A munkaterület ütemezett jelentéseit adja vissza – a más tagok által létrehozottakat is –, a legújabbal kezdve. A lista lapozható: lásd [Lapozás](https://docs.getqr.com/hu/api/introduction.md#lapozás).

**page** `integer` (default: 1)

A visszaadandó oldal, 1 vagy nagyobb.

**pageSize** `integer` (default: 100)

Találatok oldalanként, 1 és 100 között.

```bash cURL theme={null}
curl "https://getqr.com/api/v1/reports/schedules?page=1&pageSize=100" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```json 200 theme={null}
{
  "data": [
    {
      "id": "clx8f2k9a0001qk0c8vhd3xyz",
      "name": "Weekly campaign digest",
      "frequency": "weekly",
      "scope": "selected",
      "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr", "clw3n7t1x0004ab0d9rzu2wfh"],
      "filters": null,
      "includePdf": true,
      "status": "active",
      "timezone": "America/New_York",
      "locale": "en",
      "nextRunAt": "2026-08-10T04:00:00.000Z",
      "lastRunAt": "2026-08-03T04:00:12.000Z",
      "createdAt": "2026-07-01T12:34:56.000Z",
      "updatedAt": "2026-07-28T09:12:00.000Z"
    }
  ],
  "pagination": { "page": 1, "pageSize": 100, "total": 1, "hasMore": false }
}
```

## Jelentés ütemezése

`POST /api/v1/reports/schedules`

Létrehoz egy jelentést, amelyet a rendszer rendszeresen elküld e-mailben. A `nextRunAt` értékét a gyakoriság és az időzóna alapján számítja ki.

> [!NOTE]
>
> Egy QR-kód gyakoriságonként csak egy ütemezett jelentéshez tartozhat. Átfedő ütemezés esetén `409 conflict` a válasz.

Az `all` hatókörű jelentés minden más, azonos gyakoriságú jelentéssel átfed. A szüneteltetett jelentések is számítanak.

**frequency** `string` *required*

Milyen gyakran küldi a rendszer a jelentést: `daily`, `weekly` vagy `monthly`. Ez határozza meg a lefedett időszakot is. Lásd: [Időszak](#időszak).

**scope** `string` *required*

`all`, `selected` vagy `single`. Lásd: [Hatókör](#hatókör).

**timezone** `string` *required*

IANA időzóna, amelyhez a küldés időpontja és az időszak igazodik, például `America/New_York`. Ismeretlen időzóna esetén `422` a válasz.

**locale** `string` *required*

Az e-mail és a PDF nyelve, például `en` vagy `de`. Nem támogatott érték esetén angol lesz. A `zh`, `ja`, `ko` és `ar` nyelvű PDF-ek angolul készülnek.

**qrIds** `string[]`

A lefedendő QR-kódok. Kötelező a `selected` (egy vagy több azonosító) és a `single` (pontosan egy azonosító) esetén. Minden azonosítónak a munkaterület egy QR-kódjához kell tartoznia, különben a kérés `404` választ ad.

**name** `string`

Címke, amely az e-mail tárgyában és az irányítópulton jelenik meg, legfeljebb 40 karakter.

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

A jelentés PDF-változatának csatolása az e-mailhez.

```bash cURL theme={null}
curl -X POST "https://getqr.com/api/v1/reports/schedules" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Weekly campaign digest",
    "frequency": "weekly",
    "scope": "selected",
    "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
    "includePdf": true,
    "timezone": "America/New_York",
    "locale": "en"
  }'
```

```json 200 theme={null}
{
  "id": "clx8f2k9a0001qk0c8vhd3xyz",
  "name": "Weekly campaign digest",
  "frequency": "weekly",
  "scope": "selected",
  "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
  "filters": null,
  "includePdf": true,
  "status": "active",
  "timezone": "America/New_York",
  "locale": "en",
  "nextRunAt": "2026-08-10T04:00:00.000Z",
  "lastRunAt": null,
  "createdAt": "2026-08-03T12:34:56.000Z",
  "updatedAt": "2026-08-03T12:34:56.000Z"
}
```

## Ütemezett jelentés frissítése

`PATCH /api/v1/reports/schedules/{id}`

Módosít egy ütemezett jelentést, vagy szünetelteti és folytatja. Csak a módosítani kívánt mezőket küldje el, de legalább egyet. A gyakoriság vagy az időzóna módosítása, illetve egy szüneteltetett jelentés folytatása újraszámolja a `nextRunAt` értékét. A gyakoriságonként egy jelentés szabály továbbra is érvényes, így egy átfedést okozó módosítás `409` választ ad.

**id** `string` *required*

Az ütemezett jelentés azonosítója. A lista vagy a létrehozás válaszából veheti.

**status** `string`

A `paused` leállítja az e-maileket az ütemezés törlése nélkül. Az `active` folytatja őket.

**name** `string`

Címke, legfeljebb 40 karakter.

**frequency** `string`

`daily`, `weekly` vagy `monthly`.

**scope** `string`

`all`, `selected` vagy `single`.

**qrIds** `string[]`

A lefedendő QR-kódok. Minden azonosítónak a munkaterület egy QR-kódjához kell tartoznia.

**includePdf** `boolean`

PDF csatolása az e-mailhez.

**timezone** `string`

IANA időzóna.

**locale** `string`

Az e-mail és a PDF nyelve.

```bash cURL theme={null}
curl -X PATCH "https://getqr.com/api/v1/reports/schedules/clx8f2k9a0001qk0c8vhd3xyz" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Monthly campaign digest",
    "frequency": "monthly",
    "status": "active"
  }'
```

```json 200 theme={null}
{
  "id": "clx8f2k9a0001qk0c8vhd3xyz",
  "name": "Monthly campaign digest",
  "frequency": "monthly",
  "scope": "selected",
  "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
  "filters": null,
  "includePdf": true,
  "status": "active",
  "timezone": "America/New_York",
  "locale": "en",
  "nextRunAt": "2026-09-01T04:00:00.000Z",
  "lastRunAt": "2026-08-03T04:00:12.000Z",
  "createdAt": "2026-07-01T12:34:56.000Z",
  "updatedAt": "2026-08-05T10:15:00.000Z"
}
```

## Ütemezett jelentés törlése

`DELETE /api/v1/reports/schedules/{id}`

Törli az ütemezést, és leállítja az összes további e-mailt.

> [!WARNING]
>
> Az ütemezett jelentés törlése nem vonható vissza.

**id** `string` *required*

Az ütemezett jelentés azonosítója.

```bash cURL theme={null}
curl -X DELETE "https://getqr.com/api/v1/reports/schedules/clx8f2k9a0001qk0c8vhd3xyz" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```json 200 theme={null}
{ "id": "clx8f2k9a0001qk0c8vhd3xyz", "deleted": true }
```

## Gyakori problémák

> [accordion] 404-es hiba jelentés exportálásakor
>
> A `selected` vagy a `single` hatókörnél a `qrIds` egyike sem egyezett a munkaterület egy rövid linkkel rendelkező QR-kódjával. Ellenőrizze az azonosítókat.

> [accordion] 404 „QR not found.” jelentés ütemezésekor
>
> A `qrIds` valamelyike nem a munkaterület QR-kódja, vagy törölték. Ellenőrizze az azonosítókat a [QR-kódok listázása](https://docs.getqr.com/hu/api/endpoints/qr-codes.md) végponttal.

> [accordion] 409-es hiba jelentés ütemezésekor
>
> Az egyik QR-kód már egy azonos gyakoriságú ütemezett jelentéshez tartozik, vagy egy ilyen gyakoriságú jelentés `all` hatókört használ. Szerkessze vagy törölje azt a jelentést, vagy válasszon más gyakoriságot.

> [accordion] 404 "Scheduled report not found."
>
> Az `id` nem egyezik a munkaterület egyik ütemezett jelentésével sem. Vegye az [Ütemezett jelentések listázása](#ütemezett-jelentések-listázása) válaszából.

> [accordion] A jelentésből hiányoznak a mai beolvasások
>
> A jelentések csak a legutóbbi lezárult időszakot fedik le. Élő számokhoz használja az [Analitika](https://docs.getqr.com/hu/api/endpoints/analytics.md) végpontot.

## Következő lépések

> [card] [Analitika](https://docs.getqr.com/hu/api/endpoints/analytics.md)

> [card] [Ütemezett jelentések az alkalmazásban](https://docs.getqr.com/hu/analytics/scheduled-reports.md)

> [card] [Jelentések értelmezése](https://docs.getqr.com/hu/analytics/reading-reports.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.