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

# Șabloane

> Salvați designuri reutilizabile pentru coduri QR și aplicați-le codurilor QR noi.

> [!NOTE]
>
> API-ul GetQR este în versiune beta și este disponibil pentru anumite spații de lucru. Detaliile se pot schimba înainte de lansarea generală.

Un șablon stochează un design reutilizabil: `styles`, `frameOptions` și `logoOptions`. Nu conține niciodată conținut sau un link. Șabloanele sunt partajate de toți membrii spațiului de lucru.

| Metodă | Cale | Descriere |
| - | - | - |
| `GET` | `/api/v1/templates` | [Listarea șabloanelor](#listarea-șabloanelor) |
| `POST` | `/api/v1/templates` | [Crearea unui șablon](#crearea-unui-șablon) |
| `GET` | `/api/v1/templates/{templateId}` | [Obținerea unui șablon](#obținerea-unui-șablon) |
| `PATCH` | `/api/v1/templates/{templateId}` | [Actualizarea unui șablon](#actualizarea-unui-șablon) |
| `DELETE` | `/api/v1/templates/{templateId}` | [Ștergerea unui șablon](#ștergerea-unui-șablon) |
| `POST` | `/api/v1/templates/{templateId}/duplicate` | [Duplicarea unui șablon](#duplicarea-unui-șablon) |

## Aplicarea unui șablon

Transmiteți `templateId` când [creați un cod QR](https://docs.getqr.com/ro/api/endpoints/qr-codes.md). Designul șablonului se aplică noului cod QR. Oricare dintre cele trei obiecte de design trimise în aceeași cerere se aplică peste el.

* **Copiat, nu legat.** Codul QR își păstrează propria copie a designului. Editarea sau ștergerea ulterioară a șablonului nu îl modifică.
* **Doar designuri personalizate.** Un șablon cu `designKind` `branded` sau `ai` nu poate fi aplicat prin API și returnează `422` (`art_template_unsupported`).
* **Doar spațiul dvs. de lucru.** Un șablon necunoscut sau unul din alt spațiu de lucru returnează `404`.

## Anteturi

**Authorization** `string` *required*

`Bearer` urmat de cheia dvs. API. Consultați [Autentificare](https://docs.getqr.com/ro/api/authentication.md).

**Content-Type** `string`

`application/json`. Obligatoriu pentru cererile cu corp.

## Obiectul șablon

**id** `string`

ID-ul șablonului, de exemplu `qrt_8Hs2mQvKpLd4RtYw`.

**name** `string`

Numele afișat la alegerea unui șablon.

**designKind** `string`

Doar citire. `custom` este un design pe care API-ul îl poate edita complet. `branded` și `ai` sunt un design Branded sau un design AI creat în panou: imaginea lui nu poate fi editată prin API și este păstrată când modificați celelalte câmpuri de design.

**design** `object`

Designul stocat. Fiecare câmp are aceeași formă ca și câmpul cu același nume din cerere, așa că îl puteți trimite înapoi.

**properties**

**styles** `object | null`

Forma punctelor și a colțurilor și culorile.

**frameOptions** `object | null`

Cadrul din jurul codului QR și textul îndemnului la acțiune.

**logoOptions** `object | null`

Logoul din centru.

**createdAt** `string`

Data creării, ISO 8601.

**updatedAt** `string`

Data ultimei actualizări, ISO 8601.

## Listarea șabloanelor

`GET /api/v1/templates`

Returnează șabloanele spațiului dvs. de lucru, cele mai noi primele. Lista este paginată: consultați [Paginare](https://docs.getqr.com/ro/api/introduction.md#paginare).

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

Pagina returnată, 1 sau mai mult.

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

Rezultate pe pagină, de la 1 la 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 }
}
```

## Crearea unui șablon

`POST /api/v1/templates`

Salvează un design nou. Răspunde cu `201 Created`. Câmpurile de design sunt verificate în raport cu cataloagele din [Personalizare](https://docs.getqr.com/ro/api/guides/customization.md), așa că o formă, un cadru sau un logo necunoscut este respins cu `422`.

**name** `string` *required*

Numele afișat la alegerea unui șablon, între 1 și 40 de caractere.

**styles** `object`

Forma punctelor și a colțurilor și culorile. Consultați [Personalizare](https://docs.getqr.com/ro/api/guides/customization.md).

**frameOptions** `object`

Cadrul desenat în jurul codului QR și textul îndemnului la acțiune. Consultați [Personalizare](https://docs.getqr.com/ro/api/guides/customization.md).

**logoOptions** `object`

Logoul plasat în centru: un logo sugerat sau propriul fișier, încărcat cu targetul `logo` din [Fișiere](https://docs.getqr.com/ro/api/endpoints/files.md). Consultați [Personalizare](https://docs.getqr.com/ro/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"
}
```

## Obținerea unui șablon

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

**templateId** `string` *required*

ID-ul șablonului. Preluați-l din răspunsul listei sau al creării.

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

## Actualizarea unui șablon

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

Trimiteți doar câmpurile pe care vreți să le modificați. Obiectele de design sunt combinate cu designul stocat, așa că un `styles` parțial păstrează restul. Codurile QR deja create din șablon păstrează designul cu care au fost create.

**templateId** `string` *required*

ID-ul șablonului.

**name** `string`

Numele nou, între 1 și 40 de caractere.

**styles** `object`

Modificări de stil, combinate cu `styles` stocat.

**frameOptions** `object`

Modificări ale cadrului, combinate cu cadrul stocat.

**logoOptions** `object`

Modificări ale logoului, combinate cu logoul stocat.

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

## Ștergerea unui șablon

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

Șterge șablonul. Codurile QR create din el își păstrează designul.

**templateId** `string` *required*

ID-ul șablonului.

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

## Duplicarea unui șablon

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

Creează o copie numită `<name> copy`, cu propriul ID și un design independent, pe care îl puteți edita liber. Nu primește corp de cerere. Răspunde cu `201 Created`.

**templateId** `string` *required*

ID-ul șablonului care se copiază.

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

## Probleme frecvente

> [accordion] 404 "QR template not found."
>
> `templateId` nu corespunde unui șablon din spațiul dvs. de lucru. Preluați-l din [Listarea șabloanelor](#listarea-șabloanelor).

> [accordion] 422 la crearea sau actualizarea unui șablon
>
> Un câmp de design nu corespunde cataloagelor, de exemplu un tip de punct, un cadru sau un logo sugerat necunoscut. Mesajul indică câmpul. Consultați [Personalizare](https://docs.getqr.com/ro/api/guides/customization.md).

> [accordion] 422 art\_template\_unsupported la crearea unui cod QR
>
> Șablonul folosește un design Branded sau un design AI. Aplicați în schimb un șablon cu `designKind` `custom`.

## Ce urmează

> [card] [Personalizare](https://docs.getqr.com/ro/api/guides/customization.md)

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

> [card] [Șabloane în aplicație](https://docs.getqr.com/ro/templates/save-template.md)

> [card] [Fișiere](https://docs.getqr.com/ro/api/endpoints/files.md)


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