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

# Veidnes

> Saglabājiet atkārtoti izmantojamus QR kodu dizainus un piemērojiet tos jauniem QR kodiem.

> [!NOTE]
>
> GetQR API ir beta versijā un pieejams atlasītām darbvietām. Līdz vispārējai izlaišanai detaļas var mainīties.

Veidne glabā atkārtoti izmantojamu dizainu: `styles`, `frameOptions` un `logoOptions`. Tajā nekad nav satura vai saites. Veidnes ir kopīgas visiem darbvietas dalībniekiem.

| Metode | Ceļš | Apraksts |
| - | - | - |
| `GET` | `/api/v1/templates` | [Veidņu saraksts](#veidņu-saraksts) |
| `POST` | `/api/v1/templates` | [Veidnes izveide](#veidnes-izveide) |
| `GET` | `/api/v1/templates/{templateId}` | [Veidnes iegūšana](#veidnes-iegūšana) |
| `PATCH` | `/api/v1/templates/{templateId}` | [Veidnes atjaunināšana](#veidnes-atjaunināšana) |
| `DELETE` | `/api/v1/templates/{templateId}` | [Veidnes dzēšana](#veidnes-dzēšana) |
| `POST` | `/api/v1/templates/{templateId}/duplicate` | [Veidnes dublēšana](#veidnes-dublēšana) |

## Veidnes piemērošana

Nododiet `templateId`, kad [izveidojat QR kodu](https://docs.getqr.com/lv/api/endpoints/qr-codes.md). Veidnes dizains tiek piemērots jaunajam QR kodam. Jebkurš no trim dizaina objektiem, ko nosūtāt tajā pašā pieprasījumā, tiek apvienots virs tā.

* **Kopēts, nevis saistīts.** QR kods saglabā savu dizaina kopiju. Veidnes vēlāka rediģēšana vai dzēšana to nemaina.
* **Tikai Custom dizaini.** Veidni ar `designKind` `branded` vai `ai` nevar piemērot ar API, un tā atgriež `422` (`art_template_unsupported`).
* **Tikai jūsu darbvieta.** Nezināma veidne vai veidne no citas darbvietas atgriež `404`.

## Galvenes

**Authorization** `string` *required*

`Bearer`, kam seko jūsu API atslēga. Skatiet [Autentifikācija](https://docs.getqr.com/lv/api/authentication.md).

**Content-Type** `string`

`application/json`. Obligāts pieprasījumos ar pamattekstu.

## Veidnes objekts

**id** `string`

Veidnes ID, piemēram, `qrt_8Hs2mQvKpLd4RtYw`.

**name** `string`

Nosaukums, kas redzams, izvēloties veidni.

**designKind** `string`

Tikai lasāms. `custom` ir dizains, ko API var pilnībā rediģēt. `branded` un `ai` ir informācijas panelī izveidots Branded vai AI dizains: tā attēlu nevar rediģēt ar API, un tas tiek saglabāts, kad maināt citus dizaina laukus.

**design** `object`

Saglabātais dizains. Katram laukam ir tāda pati forma kā tāda paša nosaukuma pieprasījuma laukam, tāpēc varat to nosūtīt atpakaļ.

**properties**

**styles** `object | null`

Punktu un stūru formas un krāsas.

**frameOptions** `object | null`

Rāmis ap QR kodu un tā aicinājuma rīkoties teksts.

**logoOptions** `object | null`

Logotips centrā.

**createdAt** `string`

Izveides datums, ISO 8601.

**updatedAt** `string`

Pēdējās atjaunināšanas datums, ISO 8601.

## Veidņu saraksts

`GET /api/v1/templates`

Atgriež jūsu darbvietas veidnes, sākot ar jaunākajām. Saraksts ir sadalīts lapās: skatiet [Lapošana](https://docs.getqr.com/lv/api/introduction.md#lapošana).

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

Atgriežamā lapa, 1 vai vairāk.

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

Rezultāti lapā, no 1 līdz 100.

```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 }
}
```

## Veidnes izveide

`POST /api/v1/templates`

Saglabā jaunu dizainu. Atbild ar `201 Created`. Dizaina lauki tiek pārbaudīti pret katalogiem sadaļā [Pielāgošana](https://docs.getqr.com/lv/api/guides/customization.md), tāpēc nezināma forma, rāmis vai logotips tiek noraidīts ar `422`.

**name** `string` *required*

Nosaukums, kas redzams, izvēloties veidni, no 1 līdz 40 rakstzīmēm.

**styles** `object`

Punktu un stūru formas un krāsas. Skatiet [Pielāgošana](https://docs.getqr.com/lv/api/guides/customization.md).

**frameOptions** `object`

Rāmis ap QR kodu un tā aicinājuma rīkoties teksts. Skatiet [Pielāgošana](https://docs.getqr.com/lv/api/guides/customization.md).

**logoOptions** `object`

Logotips centrā: ieteiktais logotips vai jūsu fails, kas augšupielādēts ar [Faili](https://docs.getqr.com/lv/api/endpoints/files.md) target `logo`. Skatiet [Pielāgošana](https://docs.getqr.com/lv/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"
}
```

## Veidnes iegūšana

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

**templateId** `string` *required*

Veidnes ID. Ņemiet to no saraksta vai izveides atbildes.

```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"
}
```

## Veidnes atjaunināšana

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

Sūtiet tikai tos laukus, kurus vēlaties mainīt. Dizaina objekti tiek apvienoti ar saglabāto dizainu, tāpēc daļējs `styles` saglabā pārējo. No veidnes jau izveidotie QR kodi saglabā dizainu, ar kuru tie tika izveidoti.

**templateId** `string` *required*

Veidnes ID.

**name** `string`

Jauns nosaukums, no 1 līdz 40 rakstzīmēm.

**styles** `object`

Stila izmaiņas, kas tiek apvienotas ar saglabāto `styles`.

**frameOptions** `object`

Rāmja izmaiņas, kas tiek apvienotas ar saglabāto rāmi.

**logoOptions** `object`

Logotipa izmaiņas, kas tiek apvienotas ar saglabāto logotipu.

```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"
}
```

## Veidnes dzēšana

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

Dzēš veidni. No tās izveidotie QR kodi saglabā savu dizainu.

**templateId** `string` *required*

Veidnes ID.

```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 }
```

## Veidnes dublēšana

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

Izveido kopiju ar nosaukumu `<name> copy`, ar savu ID un neatkarīgu dizainu, ko varat brīvi rediģēt. Nepieņem pieprasījuma pamattekstu. Atbild ar `201 Created`.

**templateId** `string` *required*

Kopējamās veidnes ID.

```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"
}
```

## Biežākās problēmas

> [accordion] 404 "QR template not found."
>
> `templateId` neatbilst nevienai veidnei jūsu darbvietā. Ņemiet to no [veidņu saraksta](#veidņu-saraksts).

> [accordion] 422, izveidojot vai atjauninot veidni
>
> Kāds dizaina lauks neatbilst katalogiem, piemēram, nezināms punktu veids, rāmis vai ieteiktais logotips. Ziņojumā norādīts lauks. Skatiet [Pielāgošana](https://docs.getqr.com/lv/api/guides/customization.md).

> [accordion] 422 art\_template\_unsupported, izveidojot QR kodu
>
> Veidne izmanto Branded vai AI dizainu. Tā vietā piemērojiet veidni ar `designKind` `custom`.

## Kas tālāk

> [card] [Pielāgošana](https://docs.getqr.com/lv/api/guides/customization.md)

> [card] [QR kodi](https://docs.getqr.com/lv/api/endpoints/qr-codes.md)

> [card] [Veidnes lietotnē](https://docs.getqr.com/lv/templates/save-template.md)

> [card] [Faili](https://docs.getqr.com/lv/api/endpoints/files.md)


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