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

# QR-kodedata efter type

> Dataformatet, et eksempel på en forespørgsel og hvad der kan ændres efter tryk for hver af de 16 QR-kodetyper.

> [!NOTE]
>
> GetQR API'et er i beta og er tilgængeligt for udvalgte arbejdsområder. Detaljer kan ændre sig før den generelle udgivelse.

Hver QR-kode har en `qrType`, og typen bestemmer, hvad `data` skal indeholde. Denne vejledning viser formatet for hver type, en body, der virker, og hvad du stadig kan ændre, når koden er trykt.

Eksemplerne er bodies til [Opret en QR-kode](https://docs.getqr.com/da/api/endpoints/qr-codes.md#opret-en-qr-kode). Send dem sådan her:

```bash theme={null}
curl -X POST "https://getqr.com/api/v1/qrs" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "qrType": "website", "data": "https://example.com/menu", "title": "Menu" }'
```

## Alle typer i overblik

| `qrType` | `data` | Kan ændres efter tryk |
| - | - | - |
| [`website`](#website) | http(s)-URL | Ja |
| [`feedback`](#feedback) | http(s)-URL til formularen | Ja |
| [`payment`](#payment) | Betalingsudbyderens URL | Ja |
| [`whatsapp`](#whatsapp) | `wa.me`-link | Ja |
| [`location`](#location) | Kort-URL | Ja |
| [`app`](#app-link) | Butiks-URL eller tom plus `link.ios` / `link.android` | Ja |
| [`email`](#email) | `mailto:`-URI | Ja |
| [`sms`](#sms) | `sms:`-URI | Ja |
| [`wifi`](#wifi) | `WIFI:`-payload | **Nej** |
| [`pdf`, `image`, `video`](#pdf-billede-og-video) | Tom, med en `fileId` | Ja |
| [`vcard`](#vcard) | vCard 3.0-tekst | Ja |
| [`social`](#social-media) | JSON-streng | Ja |
| [`multilink`](#multi-link) | JSON-streng | Ja |
| [`event`](#event) | JSON-streng | Ja |

## Sådan løses en QR-kode

Hver QR-kode er et kortlink plus en payload. To felter bærer indholdet:

| Felt | Hvad det er |
| - | - |
| `link.url` | Hvor kortlinket sender den besøgende hen. Det er den egentlige destination for alle typer undtagen `wifi`. |
| `data` | Typens payload, kontrolleret mod `qrType`. Den gemmes kun, som den blev sendt, for `wifi`, `vcard`, `social`, `multilink`, `event` og `sms`. For alle andre typer leverer den kun `link.url`, og de gemte `data` bliver til kortlinket. Læs destinationen fra `url` i svaret. |

Regler for alle typer:

* **Standardværdier.** Ved oprettelse bliver en udeladt eller tom `link.url` sat til `data`, og du kan udelade hele `link`-objektet. Når begge sendes og er forskellige, vinder `link.url`. Send dem ens, eller send kun `data`.
* **Hvad billedet koder.** Billedet koder kortlinket for alle typer undtagen `wifi`. Derfor kan du ændre, hvor en trykt kode fører hen, og dens scanninger registreres. En WiFi-QR-kode koder selve netværket: Du kan ikke ændre den efter tryk, og dens scanninger registreres ikke.
* **Skemaer.** `link.url` accepterer kun `http:`, `https:`, `wifi:`, `mailto:`, `sms:` og `begin:`. Alt andet, herunder `geo:`, `smsto:`, `matmsg:` og `tel:`, giver `422 Invalid destination URL`, også hvor `data` accepterer det.
* **Tomme data.** Tomme `data` springer typekontrollen over. For en viderestillingstype skal `link.url` så være angivet, ellers giver kaldet `400 Missing destination URL`.
* **Struktur.** Ud over typekontrollen validerer serveren ikke payloaden. En JSON-type skal blot kunne parses som et JSON-objekt, og et vCard skal blot starte med `BEGIN:VCARD`.

> [!TIP]
>
> Grænser markeret med **Builder** nedenfor er dem, editoren i dashboardet håndhæver. API'et accepterer payloads, der ignorerer dem, men de kan blive vist forkert på landingssiden eller i editoren.

## Website

`qrType`: `"website"`. Vejledning til dashboardet: [Website-QR-kode](https://docs.getqr.com/da/qr-types/website.md).

| Felt | Adfærd |
| - | - |
| `data` | En http(s)-URL. |
| `link.url` | Destinationen. Standard er `data`. |
| `fileId` | Ikke tilladt. |
| Koder | Kortlinket, der viderestiller til `link.url`. Scanninger registreres. |
| Efter tryk | Kan ændres. Send `data` eller `link.url` for at flytte destinationen. `data` alene er nok. |

```json Request body theme={null}
{
  "qrType": "website",
  "data": "https://example.com/menu",
  "title": "Menu"
}
```

Fejl:

* `422 Expected an http(s) URL, e.g. "https://example.com" for qrType "website".`
* `422 Invalid destination URL`

## Feedback

`qrType`: `"feedback"`. Vejledning til dashboardet: [Feedback-QR-kode](https://docs.getqr.com/da/qr-types/feedback.md).

`data` er http(s)-URL'en til feedbackformularen, f.eks. en Google-formular eller en anmeldelsesside. Alt andet fungerer som for [Website](#website).

```json Request body theme={null}
{
  "qrType": "feedback",
  "data": "https://forms.gle/abc123"
}
```

## Payment

`qrType`: `"payment"`. Vejledning til dashboardet: [Betalings-QR-kode](https://docs.getqr.com/da/qr-types/payment.md).

`data` er udbyderens betalings-URL, f.eks.:

```text theme={null}
https://paypal.me/<user>/25EUR
```

Editoren i dashboardet genkender disse værter: `paypal.me`, `paypal.com/paypalme`, `cash.app`, `venmo.com`, `buy.stripe.com`, `stripe.com`, `square.link` og `payoneer.com`. For PayPal er beløbet det sidste segment i stien. Alle andre http(s)-URL'er virker også, men editoren deler dem ikke op i udbyder og beløb. Alt andet fungerer som for [Website](#website).

```json Request body theme={null}
{
  "qrType": "payment",
  "data": "https://paypal.me/acme/25EUR"
}
```

## WhatsApp

`qrType`: `"whatsapp"`. Vejledning til dashboardet: [WhatsApp-QR-kode](https://docs.getqr.com/da/qr-types/whatsapp.md).

`data` er et `wa.me`-link: det internationale nummer med cifre uden `+`, eventuelt med en forudfyldt tekst.

```text theme={null}
https://wa.me/<digits>
https://wa.me/<digits>?text=<urlencoded>
```

Serveren tjekker kun, at det er en http(s)-URL. Dashboardet læser også links af typen `api.whatsapp.com/send`. Alt andet fungerer som for [Website](#website).

```json Request body theme={null}
{
  "qrType": "whatsapp",
  "data": "https://wa.me/14155550123?text=Hi%20there"
}
```

## Location

`qrType`: `"location"`. Vejledning til dashboardet: [Lokations-QR-kode](https://docs.getqr.com/da/qr-types/location.md).

`data` er en kort-URL. Brug dette format, så QR-koden fortsat kan redigeres i dashboardet (`query_place_id` er valgfri):

```text theme={null}
https://www.google.com/maps/search/?api=1&query=<address>&query_place_coords=<lat>,<lng>&query_place_id=<id>
```

Alle andre http(s)-URL'er viderestiller også. En `geo:`-URI består `data`-kontrollen, men afvises som destination, så brug den ikke. Alt andet fungerer som for [Website](#website).

```json Request body theme={null}
{
  "qrType": "location",
  "data": "https://www.google.com/maps/search/?api=1&query=Golden+Gate+Bridge&query_place_coords=37.8199,-122.4783"
}
```

## App Link

`qrType`: `"app"`. Vejledning til dashboardet: [App Link-QR-kode](https://docs.getqr.com/da/qr-types/app-link.md).

| Felt | Adfærd |
| - | - |
| `link.ios`, `link.android` | URL'er til App Store og Google Play. Besøgende på iOS sendes til `ios`, besøgende på Android til `android`. De går forud for alt andet, når koden scannes. |
| `link.url` | Reserve til andre enheder. Standard er `data` og derefter `ios` eller `android`. |
| `data` | En http(s)-URL (dashboardet sender butiks-URL'en) eller tom. Mindst én af `link.ios`, `link.android`, `link.url` eller `data` skal være angivet, ellers giver kaldet `400 Missing destination URL`. |
| `fileId` | Ikke tilladt. |
| Koder | Kortlinket. Scanninger registreres. |
| Efter tryk | Kan ændres. `link.ios` og `link.android` anvendes hver for sig og kun, når de sendes. `null` rydder et af dem. Du behøver ikke sende `qrType` igen. Skifter du til en anden type, ryddes begge butikslinks. |

```json Request body theme={null}
{
  "qrType": "app",
  "data": "https://apps.apple.com/app/id123456789",
  "link": {
    "ios": "https://apps.apple.com/app/id123456789",
    "android": "https://play.google.com/store/apps/details?id=com.acme.app"
  }
}
```

Fejl:

* `422 Invalid URL`
* `400 Missing destination URL`

## Email

`qrType`: `"email"`. Vejledning til dashboardet: [E-mail-QR-kode](https://docs.getqr.com/da/qr-types/email.md).

```text theme={null}
mailto:<address>?subject=<subject>&body=<body>
```

| Felt | Adfærd |
| - | - |
| `data` | En `mailto:`-URI med valgfrit emne og brødtekst. Kod mellemrum som `%20`: Dashboardet skriver dem som `+`, som ikke alle mailapps læser som et mellemrum. `matmsg:` afvises som destination. |
| `link.url` | `mailto:`-URI'en. Standard er `data`. |
| `fileId` | Ikke tilladt. |
| Koder | Kortlinket, der åbner en side, som sender videre til mailappen. |
| Efter tryk | Kan ændres. Send `data` eller `link.url` for at ændre beskeden. `data` alene er nok. |

```json Request body theme={null}
{
  "qrType": "email",
  "data": "mailto:hi@example.com?subject=Hello&body=Hi%20there"
}
```

Fejl:

* `422 Expected a mailto URI, e.g. "mailto:hi@example.com?subject=Hello" for qrType "email".`

## SMS

`qrType`: `"sms"`. Vejledning til dashboardet: [SMS-QR-kode](https://docs.getqr.com/da/qr-types/sms.md).

```text theme={null}
sms:+<digits>
sms:+<digits>?body=<encodeURIComponent(text)>
```

| Felt | Adfærd |
| - | - |
| `data` | En `sms:`-URI med valgfri brødtekst. Dashboardet læser kun præcis denne form. `smsto:` afvises som destination. |
| `link.url` | `sms:`-URI'en. Standard er `data`. |
| `fileId` | Ikke tilladt. |
| Koder | Kortlinket, der åbner en side, som sender videre til beskedappen. |
| Efter tryk | Kan ændres. Send `data` eller `link.url` for at ændre beskeden. `data` alene er nok. |

```json Request body theme={null}
{
  "qrType": "sms",
  "data": "sms:+14155550123?body=Table%2012"
}
```

Fejl:

* `422 Expected an SMS URI, e.g. "sms:+14155550123?body=Hello" for qrType "sms".`

## WiFi

`qrType`: `"wifi"`. Vejledning til dashboardet: [WiFi-QR-kode](https://docs.getqr.com/da/qr-types/wifi.md).

```text theme={null}
WIFI:T:<WPA|WEP|nopass>;S:<ssid>;P:<password>;H:<true|false>;;
```

| Felt | Adfærd |
| - | - |
| `data` | Påkrævet. Behold rækkefølgen `T`, `S`, `P`, `H`: Editoren og listen i dashboardet afhænger af den. Escape `\`, `;`, `"` og `:` i SSID og adgangskode med en backslash. Til et åbent netværk bruger du `T:nopass` med et tomt `P:`. Scannere afviser `T:none`. **Builder:** SSID påkrævet, adgangskode på mindst 8 tegn, medmindre `nopass`. |
| `link.url` | Bruges ikke ved scanning. Standard er `data`. |
| `fileId` | Ikke tilladt. |
| Koder | Den rå `WIFI:`-payload, ikke kortlinket. Scanninger registreres ikke. |
| Efter tryk | **Kan ikke ændres.** Nye `data` ændrer kun fremtidige downloads. Trykte koder beholder det gamle netværk. |

```json Request body theme={null}
{
  "qrType": "wifi",
  "data": "WIFI:T:WPA;S:Cafe Guest;P:espresso42;H:false;;"
}
```

Fejl:

* `422 Expected a Wi-Fi payload, e.g. "WIFI:T:WPA;S:MyNetwork;P:secret;H:false;" for qrType "wifi".`

> [!WARNING]
>
> Skift ikke typen på en trykt WiFi-QR-kode. De trykte koder beholder det gamle netværk.

## PDF, billede og video

`qrType`: `"pdf"`, `"image"` eller `"video"`. Vejledninger til dashboardet: [PDF](https://docs.getqr.com/da/qr-types/pdf.md), [Image](https://docs.getqr.com/da/qr-types/image.md), [Video](https://docs.getqr.com/da/qr-types/video.md).

| Felt | Adfærd |
| - | - |
| `fileId` | Filen. Upload den med det target, der passer til typen: `pdf`, `image` eller `video`. Med en `fileId` bliver `link.url` til filens URL, og alt, hvad du sender i feltet, ignoreres. |
| `data` | Alt undtagen en anden types payload (`WIFI:`, `BEGIN:VCARD`, `sms:`, `mailto:`, et JSON-objekt). Tom er i orden. |
| `link.url` | Uden en `fileId` bruges `link.url` (eller `data`) som ekstern destination. Det virker, men dashboardet viser ingen fil. |
| Koder | Kortlinket, der viderestiller direkte til filen. En PDF åbnes som den rå fil, ikke på en visningsside. |
| Efter tryk | Kan ændres. Send en ny `fileId` for at erstatte filen. Den gamle frigives. |

Én fil pr. QR-kode: PDF-pakker og billedgallerier er ikke tilgængelige via API'et. Se [Ikke understøttet via API'et](#ikke-understøttet-via-api-et).

```json pdf theme={null}
{
  "qrType": "pdf",
  "data": "",
  "fileId": "file_9f8e7d6c5b4a",
  "title": "Brochure"
}
```

```json image theme={null}
{
  "qrType": "image",
  "data": "",
  "fileId": "file_3c2b1a0f9e8d",
  "title": "Floor plan"
}
```

```json video theme={null}
{
  "qrType": "video",
  "data": "",
  "fileId": "file_5e4d3c2b1a0f",
  "title": "Product demo"
}
```

Se [Filer](https://docs.getqr.com/da/api/endpoints/files.md) for at uploade filen og få dens `fileId`.

## vCard

`qrType`: `"vcard"`. Vejledning til dashboardet: [vCard-QR-kode](https://docs.getqr.com/da/qr-types/vcard.md).

| Felt | Adfærd |
| - | - |
| `data` | Påkrævet. vCard 3.0-tekst, der starter med `BEGIN:VCARD`, med linjer adskilt af `\r\n` (`\n` virker også). |
| `fileId` | Valgfrit profilbillede (target `logo`), som bruges, når `data` ikke har en `PHOTO`- eller `X-GETQR-IMAGE-FILEID`-linje. |
| `link.url` | Ignoreres og erstattes af den hostede side. Udelad det. |
| Koder | Kortlinket, der åbner den hostede kontaktside med en download til at gemme kontakten (`.vcf`). |
| Efter tryk | Kan ændres. Send nye `data` for at opdatere siden. |

Landingssiden og editoren læser kun linjeformerne nedenfor. Andre varianter, f.eks. `TEL;CELL:` eller `EMAIL;TYPE=INTERNET:`, gemmes, men vises ikke på siden.

* `N:<last>;<first>;;;`: efternavn og fornavn. **Builder:** begge påkrævet, op til 40 tegn.
* `FN:<first> <last>`: læses ikke af siden. Etiketten i listen i dashboardet kommer herfra.
* `ORG:<company>` og `TITLE:<role>`: virksomhed og stilling. **Builder:** op til 40 tegn.
* `TEL;TYPE=HOME:`, `TEL;TYPE=CELL:`, `TEL;TYPE=WORK:`, `TEL;TYPE=FAX:`: telefon-, mobil-, arbejds- og faxnumre (`+` og cifre).
* `EMAIL:<email>`: e-mailadresse.
* `URL:<url>`: website.
* `NOTE:<text>`: resumé. Escape `\\`, `\n`, `\;` og `\,`. **Builder:** op til 200 tegn.
* `ADR:;;<street>;<city>;<state>;<zip>;<country>`: adresse.
* `X-SOCIALPROFILE;TYPE=<platform>:<url>` eller `URL;TYPE=<PLATFORM>:<url>`: sociale links, én linje pr. platform.
* `PHOTO;VALUE=URI:<url>`: URL til profilbillede. Går forud for ethvert fil-id.
* `X-GETQR-IMAGE-FILEID:<fileId>`: profilbillede (target `logo`).
* `X-GETQR-PAGE-LOGO-FILEID:<fileId>`: sidelogo (target `logo`).
* `X-GETQR-LANDING-THEME:p|<0-4>` eller `X-GETQR-LANDING-THEME:c|#RRGGBB|#RRGGBB|#RRGGBB`: tema for landingssiden, enten et forudindstillet indeks (0 til 4) eller egne farver til baggrund, knapper og ikoner.

Sociale platforme: `facebook`, `whatsapp`, `instagram`, `youtube`, `tiktok`, `messenger`, `snapchat`, `linkedin`, `x`, `reddit`, `pinterest`, `telegram`, `wechat`, `viber`, `line`.

```json Request body theme={null}
{
  "qrType": "vcard",
  "data": "BEGIN:VCARD\r\nVERSION:3.0\r\nN:Doe;Jane;;;\r\nFN:Jane Doe\r\nORG:Acme\r\nTITLE:CTO\r\nTEL;TYPE=CELL:+14155550123\r\nEMAIL:jane@acme.com\r\nURL:https://acme.com\r\nX-GETQR-LANDING-THEME:p|0\r\nEND:VCARD",
  "title": "Jane Doe"
}
```

Fejl:

* `422 Expected a vCard payload starting with "BEGIN:VCARD" for qrType "vcard".`

## Social Media

`qrType`: `"social"`. Vejledning til dashboardet: [Social Media-QR-kode](https://docs.getqr.com/da/qr-types/social.md).

| Felt | Adfærd |
| - | - |
| `data` | Påkrævet. En JSON-streng, der koder et objekt. Byg den med `JSON.stringify`. |
| `fileId` | Valgfrit profilbillede på øverste niveau (target `logo`). |
| `link.url` | Ignoreres og erstattes af den hostede side. Udelad det. |
| Koder | Kortlinket, der åbner den hostede sociale side. |
| Efter tryk | Kan ændres. Send nye `data` for at opdatere siden. |

Felter i `data`:

| Felt | Type | Bemærkninger |
| - | - | - |
| `firstName` | string | Sidens overskrift og det eneste viste navn. **Builder:** påkrævet, op til 40. |
| `lastName` | string | Op til 40. Vises ikke på siden. |
| `summary` | string | Op til 200. |
| `socialLinks` | `{ platform, url }[]` | `platform` er en af [de sociale platforme for vCard](#vcard). **Builder:** hver platform kun én gang. |
| `customItems` | `{ name, url, logoFileId }[]` | **Builder:** `name` op til 40, en http(s)-`url` og en `logoFileId`. Mindst ét socialt link eller eget element i alt. |
| `fileId` | string | Profilbillede (target `logo`). `fileId` på øverste niveau er reserven. |
| `imageUrl` | string | Ekstern URL til profilbillede, som kun bruges, når der ikke er et fil-id. |
| `pageLogoFileId` | string | Sidelogo (target `logo`). |
| `landingThemeMode` | `"preset" \| "custom"` | Standard er `preset`. |
| `landingPresetIndex` | 0–4 | Standard er 0. |
| `landingCustomBg`, `landingCustomButton`, `landingCustomIcon` | `#RRGGBB` | Bruges, når tilstanden er `custom`. |

```json Request body theme={null}
{
  "qrType": "social",
  "data": "{\"firstName\":\"Acme Coffee\",\"summary\":\"Follow us\",\"socialLinks\":[{\"platform\":\"instagram\",\"url\":\"https://instagram.com/acme\"}],\"customItems\":[]}"
}
```

Fejl:

* `422 Expected a JSON object describing the social profile page for qrType "social".`

## Multi-Link

`qrType`: `"multilink"`. Vejledning til dashboardet: [Multi-Link-QR-kode](https://docs.getqr.com/da/qr-types/multi-link.md).

| Felt | Adfærd |
| - | - |
| `data` | Påkrævet. En JSON-streng, der koder et objekt. |
| `fileId` | Valgfrit profilbillede på øverste niveau (target `logo`). |
| `link.url` | Ignoreres og erstattes af den hostede side. Udelad det. |
| Koder | Kortlinket, der åbner den hostede multilink-side. |
| Efter tryk | Kan ændres. Send nye `data` for at opdatere siden. |

Felterne i `data` er de samme som for [Social Media](#social-media), bortset fra at `firstName`, `lastName` og `summary` er erstattet af:

| Felt | Type | Bemærkninger |
| - | - | - |
| `title` | string | Sidens overskrift. **Builder:** påkrævet, op til 40. |
| `description` | string | Op til 200. |

I `customItems` er `logoFileId` valgfri: Der vises et reserveikon. **Builder:** mindst ét socialt link eller ét eget element, der ikke er tomt.

```json Request body theme={null}
{
  "qrType": "multilink",
  "data": "{\"title\":\"Acme links\",\"description\":\"Everything in one place\",\"socialLinks\":[],\"customItems\":[{\"name\":\"Shop\",\"url\":\"https://acme.com/shop\",\"logoFileId\":\"\"}]}"
}
```

Fejl:

* `422 Expected a JSON object describing the multi-link page for qrType "multilink".`

## Event

`qrType`: `"event"`. Vejledning til dashboardet: [Event-QR-kode](https://docs.getqr.com/da/qr-types/event.md).

| Felt | Adfærd |
| - | - |
| `data` | Påkrævet. En JSON-streng, der koder et objekt. Ukendte eller ugyldige værdier falder tilbage til standardværdier. |
| `fileId` | Valideres (target `logo`) og gemmes, men eventsiden læser kun sit forsidebillede fra `data.fileId`. Læg forsidebilledets id i payloaden. |
| `link.url` | Ignoreres og erstattes af den hostede side. Udelad det. |
| Koder | Kortlinket, der åbner den hostede eventside med en `.ics`-download. |
| Efter tryk | Kan ændres. Send nye `data` for at opdatere siden. |

Felter i `data`:

| Felt | Type | Bemærkninger |
| - | - | - |
| `name` | string | **Builder:** påkrævet. |
| `eventType` | string | En af eventtyperne nedenfor, eller tom. |
| `start`, `end` | `"YYYY-MM-DDTHH:mm"` | Lokalt klokkeslæt i `timezone`. **Builder:** begge påkrævet, slut efter start. |
| `timezone` | IANA, f.eks. `"Europe/Berlin"` | Placerer start og slut i `.ics`-filen. Send den altid: En tom eller ukendt zone får `.ics`-filen til at behandle tiderne som UTC. |
| `street`, `zip`, `city`, `state`, `country` | string | **Builder:** `city` og `country` påkrævet, op til 40 hver. |
| `facilities` | string\[] | Id'er fra listen nedenfor. Ukendte id'er droppes. |
| `notes` | string | Fri tekst. |
| `fileId` | string | Forsidebillede (target `logo`). |
| `pageLogoFileId` | string | Sidelogo (target `logo`). |
| `organizerName`, `organizerEmail`, `mobile`, `work` | string | `mobile` og `work` op til 40. |
| `socialLinks` | `{ platform, url }[]` | [De sociale platforme for vCard](#vcard) plus `website`. |
| `ticketsUrl` | http(s)-URL | Link til køb af billetter. |
| `ticketsLabel` | string | Op til 20 tegn. Længere etiketter afkortes. Tom viser standardetiketten. |

> [accordion] Eventtyper
>
> `conference`, `seminar`, `workshop`, `training`, `webinar`, `meetup`, `networking`, `corporateEvent`, `productLaunch`, `tradeShow`, `jobFair`, `fundraiser`, `charity`, `wedding`, `engagement`, `birthday`, `anniversary`, `babyShower`, `graduation`, `reunion`, `party`, `religious`, `funeralMemorial`, `ceremony`, `concert`, `festival`, `clubNight`, `theater`, `comedy`, `filmScreening`, `exhibition`, `sports`, `tournament`, `raceMarathon`, `fitnessClass`, `foodDrink`, `market`, `openHouse`, `community`, `schoolEvent`, `kids`, `travelTour`

> [accordion] Faciliteter
>
> | Gruppe | Id'er |
> | - | - |
> | Adgang | `freeEntry`, `idRequired`, `invitationOnly`, `plusOneAllowed`, `reEntryAllowed` |
> | Alder (vælg én) | `adultsOnly`, `age18Plus`, `age21Plus`, `kidsWelcome` |
> | På stedet | `parking`, `publicTransport`, `shuttle`, `wheelchairAccess`, `evCharging`, `wifi`, `foodDrinks`, `alcoholServed`, `atm`, `coatCheck`, `pool`, `phoneCharging`, `firstAid`, `wc` |
> | Regler | `petsAllowed`, `noPets`, `smokingArea`, `noSmoking`, `noPhotos` |
> | Dresscode (vælg én) | `dressCasual`, `dressSmartCasual`, `dressBusiness`, `dressCocktail`, `dressThemed` |

```json Request body theme={null}
{
  "qrType": "event",
  "data": "{\"name\":\"Launch party\",\"eventType\":\"productLaunch\",\"start\":\"2026-11-20T18:00\",\"end\":\"2026-11-20T22:00\",\"timezone\":\"Europe/Berlin\",\"city\":\"Berlin\",\"country\":\"Germany\",\"facilities\":[\"freeEntry\"],\"socialLinks\":[],\"ticketsUrl\":\"https://acme.com/tickets\"}"
}
```

Fejl:

* `422 Expected a JSON object describing the event page for qrType "event".`

## Filer i QR-koder

Registrer en fil med [Filer](https://docs.getqr.com/da/api/endpoints/files.md), upload den, og angiv derefter dens `fileId`. Brug det target, der passer til formålet:

* **`pdf`, `image`, `video`.** Indholdet i en PDF-, billed- eller video-QR-kode.
* **`logo`.** Profilbilleder, sidelogoer, ikoner til egne links og logoer i midten.

Filer, der aldrig bliver knyttet til en QR-kode, slettes efter en frist.

`fileId`-fejl, der returneres ved oprettelse og ved `PATCH`, når `fileId` sendes:

| Status | Årsag |
| - | - |
| `422 unprocessable_entity` | Typen tager ingen fil. Kun `pdf`, `image`, `video`, `vcard`, `social`, `multilink` og `event` accepterer en. |
| `404 not_found` | Der findes ingen fil med dette id. Registrer den først med `POST /api/v1/files`. |
| `422 unprocessable_entity` | Filen blev uploadet til et andet target. F.eks. en `image`-upload på en PDF-QR-kode eller en `pdf`-, `image`- eller `video`-upload brugt som vCard-foto. |
| `422 unprocessable_entity` | Filen er registreret, men uploaden til `uploadUrl` blev aldrig gennemført. |

Fil-id'er i en payload (`fileId`, `pageLogoFileId`, `customItems[].logoFileId`, `X-GETQR-*-FILEID`-linjer) valideres ikke. De vises kun, når de er uploadet med target `logo`. QR-koden gør krav på dem, så oprydningen lader dem være.

## Skift af type

Du kan ændre `qrType` med [Opdater en QR-kode](https://docs.getqr.com/da/api/endpoints/qr-codes.md#opdater-en-qr-kode). Send `data`, der passer til den nye type: Den gemte payload hører til den gamle type, så et skift uden nye data afvises.

Efter en opdatering bestemmes destinationen i denne rækkefølge:

1. `vcard`, `social`, `multilink`, `event`: altid den hostede side.
2. En PDF-pakke eller et billedgalleri lavet i dashboardet: dens landingsside.
3. `pdf`, `image`, `video`: filens URL (en ny `fileId`, ellers den gemte).
4. `link.url`, når den sendes.
5. Ændrede `data`.
6. Den gemte URL.

Hvad hvert skift gør:

* **Væk fra `pdf`, `image` eller `video`.** `fileId` og eventuelle pakker eller gallerier ryddes.
* **Til `pdf`, `image` eller `video`.** Send også `fileId`, ellers genbruges den gemte, som kan være et vCard-foto.
* **Væk fra `app`.** Appnavnet, `link.ios` og `link.android` ryddes, så telefoner følger den nye destination.
* **Til `wifi`.** Billedet skifter til den rå payload. Koder, der allerede er trykt, indeholder stadig kortlinket, som nu viderestiller til en `wifi:`-URL.
* **Væk fra `wifi`.** Trykte koder beholder deres gamle netværk.
* **Til `vcard`, `social`, `multilink` eller `event`.** Kortlinket peges mod den nye hostede side.
* **Væk fra `vcard`, `social`, `multilink` eller `event`.** Send de nye `data`. Destinationen følger dem.

Statiske QR-koder lavet i dashboardet har intet kortlink, så ændring af deres `link.url` giver `422`.

## Ikke understøttet via API'et

Disse funktioner fra dashboardet er ikke en del af v1-API'et. Ukendte felter droppes uden fejl, så det har ingen effekt at sende dem.

| Felt | Beskrivelse |
| - | - |
| `appName` | Visningsnavnet på en App Link-QR-kode. App Link-QR-koder oprettet via API'et viser deres butiks-URL i listen i dashboardet. |
| `isStatic` | En statisk QR-kode uden kortlink. Alle QR-koder, API'et opretter, har et, så de kan redigeres og registreres efter tryk (undtagen `wifi`). |
| `pdfBundle` | En PDF-QR-kode med to eller flere filer. API'et opretter kun PDF-QR-koder med én fil. |
| `imageGallery` | En Image-QR-kode med to eller flere billeder. API'et opretter kun QR-koder med ét billede. |

Pakker og gallerier lavet i dashboardet kan stadig hentes, sættes på pause og slettes via API'et, men deres filer kan ikke ændres via det.

## Almindelige problemer

> [accordion] 422 Invalid destination URL
>
> `link.url` bruger et skema, som kortlinket ikke kan viderestille til, f.eks. `geo:`, `smsto:`, `matmsg:` eller `tel:`. Brug formaterne på denne side.

> [accordion] 400 Missing destination URL
>
> `data` er tom, og der er ingen `link.url`. For `app` skal du angive mindst én af `link.ios`, `link.android`, `link.url` eller `data`.

> [accordion] data i svaret er et kortlink, ikke min URL
>
> For linktyper er de gemte `data` kortlinket. Læs destinationen fra `url`.

> [accordion] Landingssiden mangler oplysninger fra min payload
>
> Siden læser kun de felter og linjeformer, der er angivet for typen. Andre felter gemmes, men vises ikke.

## Næste skridt

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

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

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

> [card] [Adgangsregler](https://docs.getqr.com/da/api/guides/access-rules.md)


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