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

# Sablonok

> Újrahasználható QR-kód-dizájnok mentése és alkalmazása új QR-kódokra.

> [!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 sablon egy újrahasználható dizájnt tárol: `styles`, `frameOptions` és `logoOptions`. Soha nem tartalmaz tartalmat vagy linket. A sablonokon a munkaterület minden tagja osztozik.

| Metódus | Útvonal | Leírás |
| - | - | - |
| `GET` | `/api/v1/templates` | [Sablonok listázása](#sablonok-listázása) |
| `POST` | `/api/v1/templates` | [Sablon létrehozása](#sablon-létrehozása) |
| `GET` | `/api/v1/templates/{templateId}` | [Sablon lekérése](#sablon-lekérése) |
| `PATCH` | `/api/v1/templates/{templateId}` | [Sablon frissítése](#sablon-frissítése) |
| `DELETE` | `/api/v1/templates/{templateId}` | [Sablon törlése](#sablon-törlése) |
| `POST` | `/api/v1/templates/{templateId}/duplicate` | [Sablon másolása](#sablon-másolása) |

## Sablon alkalmazása

Adja meg a `templateId` értékét, amikor [QR-kódot hoz létre](https://docs.getqr.com/hu/api/endpoints/qr-codes.md). A sablon dizájnja az új QR-kódra kerül. A három dizájnobjektum közül azok, amelyeket ugyanabban a kérésben küld, erre olvadnak rá.

* **Másolat, nem kapcsolat.** A QR-kód a dizájn saját másolatát tartja meg. A sablon későbbi szerkesztése vagy törlése nem módosítja.
* **Csak Custom dizájnok.** A `branded` vagy `ai` `designKind` értékű sablon az API-n keresztül nem alkalmazható, és `422` (`art_template_unsupported`) választ ad.
* **Csak a saját munkaterület.** Ismeretlen vagy más munkaterülethez tartozó sablon esetén `404` a válasz.

## 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`. Törzzsel rendelkező kéréseknél kötelező.

## A sablon objektum

**id** `string`

A sablon azonosítója, például `qrt_8Hs2mQvKpLd4RtYw`.

**name** `string`

A sablon választásakor megjelenő név.

**designKind** `string`

Csak olvasható. A `custom` olyan dizájn, amelyet az API teljes egészében szerkeszthet. A `branded` és az `ai` az irányítópulton készült Branded vagy AI dizájn: a képe az API-n keresztül nem szerkeszthető, és megmarad, amikor a többi dizájnmezőt módosítja.

**design** `object`

A tárolt dizájn. Minden mező felépítése megegyezik az azonos nevű kérésmezőével, így vissza is küldheti.

**properties**

**styles** `object | null`

Pont- és sarokformák és színek.

**frameOptions** `object | null`

A QR-kód körüli keret és a cselekvésre ösztönző szöveg.

**logoOptions** `object | null`

Logó középen.

**createdAt** `string`

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

**updatedAt** `string`

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

## Sablonok listázása

`GET /api/v1/templates`

A munkaterület sablonjait adja vissza, 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/templates?page=1&pageSize=100" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```json 200 theme={null}
{
  "data": [
    {
      "id": "qrt_8Hs2mQvKpLd4RtYw",
      "name": "Brand blue",
      "designKind": "custom",
      "design": {
        "styles": {
          "dotsOptions": { "type": "rounded", "color": "#1E40AF" },
          "backgroundOptions": { "color": "#FFFFFF" }
        },
        "frameOptions": null,
        "logoOptions": null
      },
      "createdAt": "2026-07-20T09:12:00.000Z",
      "updatedAt": "2026-07-20T09:12:00.000Z"
    }
  ],
  "pagination": { "page": 1, "pageSize": 100, "total": 1, "hasMore": false }
}
```

## Sablon létrehozása

`POST /api/v1/templates`

Új dizájnt ment. `201 Created` kóddal válaszol. A dizájnmezőket a rendszer a [Testreszabás](https://docs.getqr.com/hu/api/guides/customization.md) oldalon felsorolt katalógusokhoz méri, így az ismeretlen formát, keretet vagy logót `422` hibával elutasítja.

**name** `string` *required*

A sablon választásakor megjelenő név, 1–40 karakter.

**styles** `object`

Pont- és sarokformák és színek. Lásd: [Testreszabás](https://docs.getqr.com/hu/api/guides/customization.md).

**frameOptions** `object`

A QR-kód köré rajzolt keret és a cselekvésre ösztönző szöveg. Lásd: [Testreszabás](https://docs.getqr.com/hu/api/guides/customization.md).

**logoOptions** `object`

Középre helyezett logó: javasolt logó, vagy saját, a [Fájlok](https://docs.getqr.com/hu/api/endpoints/files.md) végpont `logo` céljával feltöltött fájl. Lásd: [Testreszabás](https://docs.getqr.com/hu/api/guides/customization.md).

```bash cURL theme={null}
curl -X POST "https://getqr.com/api/v1/templates" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Brand blue",
    "styles": {
      "dotsOptions": { "type": "rounded", "color": "#1E40AF" },
      "backgroundOptions": { "color": "#FFFFFF" }
    }
  }'
```

```json 201 theme={null}
{
  "id": "qrt_8Hs2mQvKpLd4RtYw",
  "name": "Brand blue",
  "designKind": "custom",
  "design": {
    "styles": {
      "dotsOptions": { "type": "rounded", "color": "#1E40AF" },
      "backgroundOptions": { "color": "#FFFFFF" }
    },
    "frameOptions": null,
    "logoOptions": null
  },
  "createdAt": "2026-07-20T09:12:00.000Z",
  "updatedAt": "2026-07-20T09:12:00.000Z"
}
```

## Sablon lekérése

`GET /api/v1/templates/{templateId}`

**templateId** `string` *required*

A sablon azonosítója. A lista vagy a létrehozás válaszából veheti.

```bash cURL theme={null}
curl "https://getqr.com/api/v1/templates/qrt_8Hs2mQvKpLd4RtYw" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```json 200 theme={null}
{
  "id": "qrt_8Hs2mQvKpLd4RtYw",
  "name": "Brand blue",
  "designKind": "custom",
  "design": {
    "styles": {
      "dotsOptions": { "type": "rounded", "color": "#1E40AF" },
      "backgroundOptions": { "color": "#FFFFFF" }
    },
    "frameOptions": null,
    "logoOptions": null
  },
  "createdAt": "2026-07-20T09:12:00.000Z",
  "updatedAt": "2026-07-20T09:12:00.000Z"
}
```

## Sablon frissítése

`PATCH /api/v1/templates/{templateId}`

Csak a módosítani kívánt mezőket küldje el. A dizájnobjektumok a tárolt dizájnba olvadnak, így egy részleges `styles` a többit megtartja. A sablonból már létrehozott QR-kódok megtartják azt a dizájnt, amellyel készültek.

**templateId** `string` *required*

A sablon azonosítója.

**name** `string`

Új név, 1–40 karakter.

**styles** `object`

Stílusmódosítások, a tárolt `styles` objektumba olvasztva.

**frameOptions** `object`

Keretmódosítások, a tárolt keretbe olvasztva.

**logoOptions** `object`

Logómódosítások, a tárolt logóba olvasztva.

```bash cURL theme={null}
curl -X PATCH "https://getqr.com/api/v1/templates/qrt_8Hs2mQvKpLd4RtYw" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Brand blue (2026)" }'
```

```json 200 theme={null}
{
  "id": "qrt_8Hs2mQvKpLd4RtYw",
  "name": "Brand blue (2026)",
  "designKind": "custom",
  "design": {
    "styles": {
      "dotsOptions": { "type": "rounded", "color": "#1E40AF" },
      "backgroundOptions": { "color": "#FFFFFF" }
    },
    "frameOptions": null,
    "logoOptions": null
  },
  "createdAt": "2026-07-20T09:12:00.000Z",
  "updatedAt": "2026-08-14T09:00:00.000Z"
}
```

## Sablon törlése

`DELETE /api/v1/templates/{templateId}`

Törli a sablont. A belőle létrehozott QR-kódok megtartják a dizájnjukat.

**templateId** `string` *required*

A sablon azonosítója.

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

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

## Sablon másolása

`POST /api/v1/templates/{templateId}/duplicate`

Másolatot készít `<name> copy` néven, saját azonosítóval és önálló dizájnnal, amelyet szabadon szerkeszthet. Nem vár kéréstörzset. `201 Created` kóddal válaszol.

**templateId** `string` *required*

A másolandó sablon azonosítója.

```bash cURL theme={null}
curl -X POST "https://getqr.com/api/v1/templates/qrt_8Hs2mQvKpLd4RtYw/duplicate" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```json 201 theme={null}
{
  "id": "qrt_2Kd9pLm4Xs7BnVcQ",
  "name": "Brand blue copy",
  "designKind": "custom",
  "design": {
    "styles": {
      "dotsOptions": { "type": "rounded", "color": "#1E40AF" },
      "backgroundOptions": { "color": "#FFFFFF" }
    },
    "frameOptions": null,
    "logoOptions": null
  },
  "createdAt": "2026-08-14T09:30:00.000Z",
  "updatedAt": "2026-08-14T09:30:00.000Z"
}
```

## Gyakori problémák

> [accordion] 404 "QR template not found."
>
> A `templateId` nem egyezik a munkaterület egyik sablonjával sem. Vegye a [Sablonok listázása](#sablonok-listázása) válaszából.

> [accordion] 422-es hiba sablon létrehozásakor vagy frissítésekor
>
> Egy dizájnmező nem felel meg a katalógusoknak, például ismeretlen pontstílus, keret vagy javasolt logó. Az üzenet megnevezi a mezőt. Lásd: [Testreszabás](https://docs.getqr.com/hu/api/guides/customization.md).

> [accordion] 422 art\_template\_unsupported QR-kód létrehozásakor
>
> A sablon Branded vagy AI dizájnt használ. Helyette `custom` `designKind` értékű sablont alkalmazzon.

## Következő lépések

> [card] [Testreszabás](https://docs.getqr.com/hu/api/guides/customization.md)

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

> [card] [Sablonok az alkalmazásban](https://docs.getqr.com/hu/templates/save-template.md)

> [card] [Fájlok](https://docs.getqr.com/hu/api/endpoints/files.md)


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