> ## 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 koda dati pēc veida > Datu formāts, pieprasījuma piemērs un rediģēšana pēc izdrukāšanas katram no 16 QR kodu veidiem. > [!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. Katram QR kodam ir `qrType`, un veids nosaka, kas jāsatur laukam `data`. Šajā ceļvedī katram veidam ir norādīts formāts, strādājošs pieprasījuma pamatteksts un tas, ko vēl varat mainīt pēc koda izdrukāšanas. Piemēri ir pieprasījuma pamatteksti galapunktam [QR koda izveide](https://docs.getqr.com/lv/api/endpoints/qr-codes.md#qr-koda-izveide). Sūtiet tos šādi: ```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" }' ``` ## Visi veidi īsumā | `qrType` | `data` | Rediģējams pēc izdrukāšanas | | - | - | - | | [`website`](#website) | http(s) URL | Jā | | [`feedback`](#atsauksmes) | Veidlapas http(s) URL | Jā | | [`payment`](#maksājums) | Maksājumu pakalpojuma URL | Jā | | [`whatsapp`](#whatsapp) | `wa.me` saite | Jā | | [`location`](#atrašanās-vieta) | Kartes URL | Jā | | [`app`](#lietotnes-saite) | Veikala URL vai tukšs, kā arī `link.ios` / `link.android` | Jā | | [`email`](#e-pasts) | `mailto:` URI | Jā | | [`sms`](#sms) | `sms:` URI | Jā | | [`wifi`](#wifi) | `WIFI:` saturs | **Nē** | | [`pdf`, `image`, `video`](#pdf-image-un-video) | Tukšs, ar `fileId` | Jā | | [`vcard`](#vcard) | vCard 3.0 teksts | Jā | | [`social`](#social-media) | JSON virkne | Jā | | [`multilink`](#multi-link) | JSON virkne | Jā | | [`event`](#pasākums) | JSON virkne | Jā | ## Kā QR kods novirza uz mērķi Katrs QR kods ir īsā saite un saturs. Saturu nes divi lauki: | Lauks | Kas tas ir | | - | - | | `link.url` | Kurp īsā saite nosūta apmeklētāju. Tas ir īstais mērķis visiem veidiem, izņemot `wifi`. | | `data` | Veida saturs, kas tiek pārbaudīts pret `qrType`. Tas tiek saglabāts nemainīts tikai veidiem `wifi`, `vcard`, `social`, `multilink`, `event` un `sms`. Visiem pārējiem veidiem tas tikai nosaka `link.url`, un saglabātais `data` kļūst par īso saiti. Mērķi nolasiet no `url` atbildē. | Noteikumi visiem veidiem: * **Noklusējumi.** Izveidojot QR kodu, izlaists vai tukšs `link.url` kļūst par `data`, un visu objektu `link` varat neiekļaut. Ja nosūtīti abi un tie atšķiras, priekšroka ir `link.url`. Sūtiet tos vienādus vai sūtiet tikai `data`. * **Ko kodē attēls.** Attēls kodē īso saiti visiem veidiem, izņemot `wifi`. Tāpēc varat mainīt, kurp ved izdrukāts kods, un tā skenējumi tiek izsekoti. WiFi QR kods kodē pašu tīklu: pēc izdrukāšanas to nevar mainīt, un tā skenējumi netiek izsekoti. * **Shēmas.** `link.url` pieņem tikai `http:`, `https:`, `wifi:`, `mailto:`, `sms:` un `begin:`. Jebkas cits, ieskaitot `geo:`, `smsto:`, `matmsg:` un `tel:`, saņem `422 Invalid destination URL`, pat ja `data` to pieņem. * **Tukši dati.** Tukšs `data` izlaiž veida pārbaudi. Novirzīšanas veidam tad jābūt iestatītam `link.url`, citādi izsaukums saņem `400 Missing destination URL`. * **Struktūra.** Papildus veida pārbaudei serveris saturu nevalidē. JSON veidam saturam jābūt tikai parsējamam kā JSON objektam, un vCard saturam jāsākas ar `BEGIN:VCARD`. > [!TIP] > > Tālāk ar **Veidotājs** atzīmētie ierobežojumi ir tie, ko piemēro informācijas paneļa redaktors. API pieņem saturu, kas tos neievēro, bet tas var neparasti attēloties galamērķa lapā vai redaktorā. ## Website `qrType`: `"website"`. Ceļvedis informācijas panelim: [Website QR kods](https://docs.getqr.com/lv/qr-types/website.md). | Lauks | Darbība | | - | - | | `data` | http(s) URL. | | `link.url` | Mērķis. Noklusējums ir `data`. | | `fileId` | Nav atļauts. | | Kodē | Īso saiti, kas novirza uz `link.url`. Skenējumi tiek izsekoti. | | Pēc izdrukāšanas | Rediģējams. Lai mainītu mērķi, sūtiet `data` vai `link.url`. Pietiek ar `data` vien. | ```json Request body theme={null} { "qrType": "website", "data": "https://example.com/menu", "title": "Menu" } ``` Kļūdas: * `422 Expected an http(s) URL, e.g. "https://example.com" for qrType "website".` * `422 Invalid destination URL` ## Atsauksmes `qrType`: `"feedback"`. Ceļvedis informācijas panelim: [Atsauksmju QR kods](https://docs.getqr.com/lv/qr-types/feedback.md). `data` ir atsauksmju veidlapas http(s) URL, piemēram, Google Form vai atsauksmju lapa. Viss pārējais darbojas tāpat kā veidam [Website](#website). ```json Request body theme={null} { "qrType": "feedback", "data": "https://forms.gle/abc123" } ``` ## Maksājums `qrType`: `"payment"`. Ceļvedis informācijas panelim: [Maksājuma QR kods](https://docs.getqr.com/lv/qr-types/payment.md). `data` ir pakalpojuma sniedzēja maksājuma URL, piemēram: ```text theme={null} https://paypal.me//25EUR ``` Informācijas paneļa redaktors atpazīst šos resursdatorus: `paypal.me`, `paypal.com/paypalme`, `cash.app`, `venmo.com`, `buy.stripe.com`, `stripe.com`, `square.link` un `payoneer.com`. PayPal gadījumā summa ir ceļa pēdējais segments. Der arī jebkurš cits http(s) URL, taču redaktors to nesadalīs pakalpojuma sniedzējā un summā. Viss pārējais darbojas tāpat kā veidam [Website](#website). ```json Request body theme={null} { "qrType": "payment", "data": "https://paypal.me/acme/25EUR" } ``` ## WhatsApp `qrType`: `"whatsapp"`. Ceļvedis informācijas panelim: [WhatsApp QR kods](https://docs.getqr.com/lv/qr-types/whatsapp.md). `data` ir `wa.me` saite: starptautisks numurs cipariem bez `+`, pēc izvēles ar iepriekš aizpildītu tekstu. ```text theme={null} https://wa.me/ https://wa.me/?text= ``` Serveris pārbauda tikai to, vai tas ir http(s) URL. Informācijas panelis nolasa arī `api.whatsapp.com/send` saites. Viss pārējais darbojas tāpat kā veidam [Website](#website). ```json Request body theme={null} { "qrType": "whatsapp", "data": "https://wa.me/14155550123?text=Hi%20there" } ``` ## Atrašanās vieta `qrType`: `"location"`. Ceļvedis informācijas panelim: [Atrašanās vietas QR kods](https://docs.getqr.com/lv/qr-types/location.md). `data` ir kartes URL. Izmantojiet šo formātu, lai QR kods paliktu rediģējams informācijas panelī (`query_place_id` nav obligāts): ```text theme={null} https://www.google.com/maps/search/?api=1&query=
&query_place_coords=,&query_place_id= ``` Novirza arī jebkurš cits http(s) URL. `geo:` URI iztur `data` pārbaudi, bet tiek noraidīts kā mērķis, tāpēc neizmantojiet to. Viss pārējais darbojas tāpat kā veidam [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" } ``` ## Lietotnes saite `qrType`: `"app"`. Ceļvedis informācijas panelim: [Lietotnes saites QR kods](https://docs.getqr.com/lv/qr-types/app-link.md). | Lauks | Darbība | | - | - | | `link.ios`, `link.android` | App Store un Google Play URL. iOS apmeklētāji nonāk uz `ios`, Android apmeklētāji uz `android`. Skenējot tiem ir priekšroka pār visu pārējo. | | `link.url` | Rezerves mērķis citām ierīcēm. Noklusējums ir `data`, pēc tam `ios` vai `android`. | | `data` | http(s) URL (informācijas panelis sūta veikala URL) vai tukšs. Jābūt iestatītam vismaz vienam no `link.ios`, `link.android`, `link.url` vai `data`, citādi izsaukums saņem `400 Missing destination URL`. | | `fileId` | Nav atļauts. | | Kodē | Īso saiti. Skenējumi tiek izsekoti. | | Pēc izdrukāšanas | Rediģējams. `link.ios` un `link.android` tiek piemēroti neatkarīgi, katrs tikai tad, ja nosūtīts. `null` notīra vienu no tiem. `qrType` nav jānosūta atkārtoti. Pārejot uz citu veidu, abas veikalu saites tiek notīrītas. | ```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" } } ``` Kļūdas: * `422 Invalid URL` * `400 Missing destination URL` ## E-pasts `qrType`: `"email"`. Ceļvedis informācijas panelim: [E-pasta QR kods](https://docs.getqr.com/lv/qr-types/email.md). ```text theme={null} mailto:
?subject=&body= ``` | Lauks | Darbība | | - | - | | `data` | `mailto:` URI ar neobligātu tēmu un tekstu. Kodējiet atstarpes kā `%20`: informācijas panelis tās raksta kā `+`, ko ne katra pasta lietotne nolasa kā atstarpi. `matmsg:` tiek noraidīts kā mērķis. | | `link.url` | `mailto:` URI. Noklusējums ir `data`. | | `fileId` | Nav atļauts. | | Kodē | Īso saiti, kas atver lapu, kura nodod lietotāju pasta lietotnei. | | Pēc izdrukāšanas | Rediģējams. Lai mainītu ziņojumu, sūtiet `data` vai `link.url`. Pietiek ar `data` vien. | ```json Request body theme={null} { "qrType": "email", "data": "mailto:hi@example.com?subject=Hello&body=Hi%20there" } ``` Kļūdas: * `422 Expected a mailto URI, e.g. "mailto:hi@example.com?subject=Hello" for qrType "email".` ## SMS `qrType`: `"sms"`. Ceļvedis informācijas panelim: [SMS QR kods](https://docs.getqr.com/lv/qr-types/sms.md). ```text theme={null} sms:+ sms:+?body= ``` | Lauks | Darbība | | - | - | | `data` | `sms:` URI ar neobligātu ziņas tekstu. Informācijas panelis nolasa tikai tieši šo formu. `smsto:` tiek noraidīts kā mērķis. | | `link.url` | `sms:` URI. Noklusējums ir `data`. | | `fileId` | Nav atļauts. | | Kodē | Īso saiti, kas atver lapu, kura nodod lietotāju ziņapmaiņas lietotnei. | | Pēc izdrukāšanas | Rediģējams. Lai mainītu ziņu, sūtiet `data` vai `link.url`. Pietiek ar `data` vien. | ```json Request body theme={null} { "qrType": "sms", "data": "sms:+14155550123?body=Table%2012" } ``` Kļūdas: * `422 Expected an SMS URI, e.g. "sms:+14155550123?body=Hello" for qrType "sms".` ## WiFi `qrType`: `"wifi"`. Ceļvedis informācijas panelim: [WiFi QR kods](https://docs.getqr.com/lv/qr-types/wifi.md). ```text theme={null} WIFI:T:;S:;P:;H:;; ``` | Lauks | Darbība | | - | - | | `data` | Obligāts. Saglabājiet secību `T`, `S`, `P`, `H`: no tās ir atkarīgs informācijas paneļa redaktors un saraksts. SSID un parolē aizsargājiet `\`, `;`, `"` un `:` ar atpakaļvērsto slīpsvītru. Atvērtam tīklam izmantojiet `T:nopass` ar tukšu `P:`. Skeneri noraida `T:none`. **Veidotājs:** SSID obligāts, parole vismaz 8 rakstzīmes, ja vien nav `nopass`. | | `link.url` | Skenējot netiek izmantots. Noklusējums ir `data`. | | `fileId` | Nav atļauts. | | Kodē | Neapstrādātu `WIFI:` saturu, nevis īso saiti. Skenējumi netiek izsekoti. | | Pēc izdrukāšanas | **Nav rediģējams.** Jauns `data` maina tikai turpmākās lejupielādes. Izdrukātie kodi saglabā veco tīklu. | ```json Request body theme={null} { "qrType": "wifi", "data": "WIFI:T:WPA;S:Cafe Guest;P:espresso42;H:false;;" } ``` Kļūdas: * `422 Expected a Wi-Fi payload, e.g. "WIFI:T:WPA;S:MyNetwork;P:secret;H:false;" for qrType "wifi".` > [!WARNING] > > Nemainiet izdrukāta WiFi QR koda veidu. Izdrukātie kodi saglabā veco tīklu. ## PDF, Image un Video `qrType`: `"pdf"`, `"image"` vai `"video"`. Ceļveži informācijas panelim: [PDF](https://docs.getqr.com/lv/qr-types/pdf.md), [Image](https://docs.getqr.com/lv/qr-types/image.md), [Video](https://docs.getqr.com/lv/qr-types/video.md). | Lauks | Darbība | | - | - | | `fileId` | Fails. Augšupielādējiet to ar veidam atbilstošo target: `pdf`, `image` vai `video`. Ar `fileId` lauks `link.url` kļūst par faila URL, un viss, ko tajā nosūtāt, tiek ignorēts. | | `data` | Jebkas, izņemot cita veida saturu (`WIFI:`, `BEGIN:VCARD`, `sms:`, `mailto:`, JSON objektu). Var būt tukšs. | | `link.url` | Bez `fileId` lauks `link.url` (vai `data`) tiek izmantots kā ārējs mērķis. Tas darbojas, bet informācijas panelis failu nerāda. | | Kodē | Īso saiti, kas novirza tieši uz failu. PDF atveras kā neapstrādāts fails, nevis skatītāja lapā. | | Pēc izdrukāšanas | Rediģējams. Lai aizstātu failu, sūtiet jaunu `fileId`. Vecais fails tiek atbrīvots. | Viens fails uz QR kodu: PDF komplekti un attēlu galerijas API nav pieejami. Skatiet [Nav pieejams API](#nav-pieejams-api). ```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" } ``` Kā augšupielādēt failu un iegūt tā `fileId`, skatiet [Faili](https://docs.getqr.com/lv/api/endpoints/files.md). ## vCard `qrType`: `"vcard"`. Ceļvedis informācijas panelim: [vCard QR kods](https://docs.getqr.com/lv/qr-types/vcard.md). | Lauks | Darbība | | - | - | | `data` | Obligāts. vCard 3.0 teksts, kas sākas ar `BEGIN:VCARD`, rindas atdalītas ar `\r\n` (der arī `\n`). | | `fileId` | Neobligāts profila attēls (target `logo`), ko izmanto, ja `data` nav rindas `PHOTO` vai `X-GETQR-IMAGE-FILEID`. | | `link.url` | Tiek ignorēts un aizstāts ar mitināto lapu. Nesūtiet to. | | Kodē | Īso saiti, kas atver mitināto kontakta lapu ar kontakta saglabāšanas (`.vcf`) lejupielādi. | | Pēc izdrukāšanas | Rediģējams. Lai atjauninātu lapu, sūtiet jaunu `data`. | Galamērķa lapa un redaktors nolasa tikai tālāk norādītās rindu formas. Citi varianti, piemēram, `TEL;CELL:` vai `EMAIL;TYPE=INTERNET:`, tiek saglabāti, bet lapā neparādās. * `N:;;;;`: uzvārds un vārds. **Veidotājs:** abi obligāti, līdz 40 rakstzīmēm. * `FN: `: lapa to nenolasa. No tā tiek ņemts nosaukums informācijas paneļa sarakstā. * `ORG:` un `TITLE:`: uzņēmums un amats. **Veidotājs:** līdz 40 rakstzīmēm. * `TEL;TYPE=HOME:`, `TEL;TYPE=CELL:`, `TEL;TYPE=WORK:`, `TEL;TYPE=FAX:`: tālruņa, mobilā, darba un faksa numuri (`+` un cipari). * `EMAIL:`: e-pasta adrese. * `URL:`: tīmekļa vietne. * `NOTE:`: kopsavilkums. Aizsargājiet `\\`, `\n`, `\;` un `\,`. **Veidotājs:** līdz 200 rakstzīmēm. * `ADR:;;;;;;`: adrese. * `X-SOCIALPROFILE;TYPE=:` vai `URL;TYPE=:`: sociālo tīklu saites, viena rinda katrai platformai. * `PHOTO;VALUE=URI:`: profila attēla URL. Tam ir priekšroka pār jebkuru faila ID. * `X-GETQR-IMAGE-FILEID:`: profila attēls (target `logo`). * `X-GETQR-PAGE-LOGO-FILEID:`: lapas logotips (target `logo`). * `X-GETQR-LANDING-THEME:p|<0-4>` vai `X-GETQR-LANDING-THEME:c|#RRGGBB|#RRGGBB|#RRGGBB`: lapas tēma, vai nu sagataves indekss (no 0 līdz 4), vai pielāgotas fona, pogu un ikonu krāsas. Sociālās platformas: `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" } ``` Kļūdas: * `422 Expected a vCard payload starting with "BEGIN:VCARD" for qrType "vcard".` ## Social Media `qrType`: `"social"`. Ceļvedis informācijas panelim: [Social Media QR kods](https://docs.getqr.com/lv/qr-types/social.md). | Lauks | Darbība | | - | - | | `data` | Obligāts. JSON virkne, kas kodē objektu. Veidojiet to ar `JSON.stringify`. | | `fileId` | Neobligāts augstākā līmeņa profila attēls (target `logo`). | | `link.url` | Tiek ignorēts un aizstāts ar mitināto lapu. Nesūtiet to. | | Kodē | Īso saiti, kas atver mitināto sociālo tīklu lapu. | | Pēc izdrukāšanas | Rediģējams. Lai atjauninātu lapu, sūtiet jaunu `data`. | Lauki objektā `data`: | Lauks | Tips | Piezīmes | | - | - | - | | `firstName` | string | Lapas virsraksts un vienīgais rādītais vārds. **Veidotājs:** obligāts, līdz 40. | | `lastName` | string | Līdz 40. Lapā netiek rādīts. | | `summary` | string | Līdz 200. | | `socialLinks` | `{ platform, url }[]` | `platform` ir viena no [vCard sociālajām platformām](#vcard). **Veidotājs:** katra platforma vienu reizi. | | `customItems` | `{ name, url, logoFileId }[]` | **Veidotājs:** `name` līdz 40, http(s) `url` un `logoFileId`. Kopā vismaz viena sociālā tīkla saite vai pielāgots elements. | | `fileId` | string | Profila attēls (target `logo`). Rezerves variants ir augstākā līmeņa `fileId`. | | `imageUrl` | string | Ārējs profila attēla URL, ko izmanto tikai tad, ja nav faila ID. | | `pageLogoFileId` | string | Lapas logotips (target `logo`). | | `landingThemeMode` | `"preset" \| "custom"` | Noklusējums ir `preset`. | | `landingPresetIndex` | 0–4 | Noklusējums ir 0. | | `landingCustomBg`, `landingCustomButton`, `landingCustomIcon` | `#RRGGBB` | Tiek izmantots, ja režīms ir `custom`. | ```json Request body theme={null} { "qrType": "social", "data": "{\"firstName\":\"Acme Coffee\",\"summary\":\"Follow us\",\"socialLinks\":[{\"platform\":\"instagram\",\"url\":\"https://instagram.com/acme\"}],\"customItems\":[]}" } ``` Kļūdas: * `422 Expected a JSON object describing the social profile page for qrType "social".` ## Multi-Link `qrType`: `"multilink"`. Ceļvedis informācijas panelim: [Multi-Link QR kods](https://docs.getqr.com/lv/qr-types/multi-link.md). | Lauks | Darbība | | - | - | | `data` | Obligāts. JSON virkne, kas kodē objektu. | | `fileId` | Neobligāts augstākā līmeņa profila attēls (target `logo`). | | `link.url` | Tiek ignorēts un aizstāts ar mitināto lapu. Nesūtiet to. | | Kodē | Īso saiti, kas atver mitināto vairāku saišu lapu. | | Pēc izdrukāšanas | Rediģējams. Lai atjauninātu lapu, sūtiet jaunu `data`. | Lauki objektā `data` ir tādi paši kā veidam [Social Media](#social-media), tikai `firstName`, `lastName` un `summary` vietā ir: | Lauks | Tips | Piezīmes | | - | - | - | | `title` | string | Lapas virsraksts. **Veidotājs:** obligāts, līdz 40. | | `description` | string | Līdz 200. | Masīvā `customItems` lauks `logoFileId` nav obligāts: tiek rādīta rezerves ikona. **Veidotājs:** vismaz viena sociālā tīkla saite vai viens netukšs pielāgots elements. ```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\":\"\"}]}" } ``` Kļūdas: * `422 Expected a JSON object describing the multi-link page for qrType "multilink".` ## Pasākums `qrType`: `"event"`. Ceļvedis informācijas panelim: [Pasākuma QR kods](https://docs.getqr.com/lv/qr-types/event.md). | Lauks | Darbība | | - | - | | `data` | Obligāts. JSON virkne, kas kodē objektu. Nezināmas vai nederīgas vērtības tiek aizstātas ar noklusējuma vērtībām. | | `fileId` | Tiek validēts (target `logo`) un saglabāts, bet pasākuma lapa vāka attēlu nolasa tikai no `data.fileId`. Ievietojiet vāka attēla ID saturā. | | `link.url` | Tiek ignorēts un aizstāts ar mitināto lapu. Nesūtiet to. | | Kodē | Īso saiti, kas atver mitināto pasākuma lapu ar `.ics` lejupielādi. | | Pēc izdrukāšanas | Rediģējams. Lai atjauninātu lapu, sūtiet jaunu `data`. | Lauki objektā `data`: | Lauks | Tips | Piezīmes | | - | - | - | | `name` | string | **Veidotājs:** obligāts. | | `eventType` | string | Viens no tālāk norādītajiem pasākumu veidiem vai tukšs. | | `start`, `end` | `"YYYY-MM-DDTHH:mm"` | Vietējais laiks laika joslā `timezone`. **Veidotājs:** abi obligāti, beigas pēc sākuma. | | `timezone` | IANA, piemēram, `"Europe/Berlin"` | Nosaka sākuma un beigu laika joslu failā `.ics`. Sūtiet to vienmēr: ja josla ir tukša vai nezināma, `.ics` laikus uztver kā UTC. | | `street`, `zip`, `city`, `state`, `country` | string | **Veidotājs:** `city` un `country` obligāti, katrs līdz 40. | | `facilities` | string\[] | ID no tālāk dotā saraksta. Nezināmi ID tiek izmesti. | | `notes` | string | Brīvs teksts. | | `fileId` | string | Vāka attēls (target `logo`). | | `pageLogoFileId` | string | Lapas logotips (target `logo`). | | `organizerName`, `organizerEmail`, `mobile`, `work` | string | `mobile` un `work` līdz 40. | | `socialLinks` | `{ platform, url }[]` | [vCard sociālās platformas](#vcard), kā arī `website`. | | `ticketsUrl` | http(s) URL | Saite biļešu iegādei. | | `ticketsLabel` | string | Līdz 20 rakstzīmēm. Garāki uzraksti tiek apgriezti. Ja tukšs, tiek rādīts noklusējuma uzraksts. | > [accordion] Pasākumu veidi > > `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] Ērtības > > | Grupa | ID | > | - | - | > | Ieeja | `freeEntry`, `idRequired`, `invitationOnly`, `plusOneAllowed`, `reEntryAllowed` | > | Vecums (izvēlieties vienu) | `adultsOnly`, `age18Plus`, `age21Plus`, `kidsWelcome` | > | Uz vietas | `parking`, `publicTransport`, `shuttle`, `wheelchairAccess`, `evCharging`, `wifi`, `foodDrinks`, `alcoholServed`, `atm`, `coatCheck`, `pool`, `phoneCharging`, `firstAid`, `wc` | > | Noteikumi | `petsAllowed`, `noPets`, `smokingArea`, `noSmoking`, `noPhotos` | > | Ģērbšanās kods (izvēlieties vienu) | `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\"}" } ``` Kļūdas: * `422 Expected a JSON object describing the event page for qrType "event".` ## Faili QR kodos Reģistrējiet failu ar [Faili](https://docs.getqr.com/lv/api/endpoints/files.md), augšupielādējiet to un pēc tam nododiet tā `fileId`. Izmantojiet lietojumam atbilstošo target: * **`pdf`, `image`, `video`.** PDF, Image vai Video QR koda saturs. * **`logo`.** Profila attēli, lapu logotipi, pielāgoto saišu ikonas un logotipi centrā. Faili, kas nekad netiek piesaistīti QR kodam, pēc noteikta laika tiek dzēsti. `fileId` kļūdas, kas tiek atgrieztas izveidē un pieprasījumā `PATCH`, ja nosūtīts `fileId`: | Statuss | Cēlonis | | - | - | | `422 unprocessable_entity` | Šis veids failu nepieņem. Failu pieņem tikai `pdf`, `image`, `video`, `vcard`, `social`, `multilink` un `event`. | | `404 not_found` | Faila ar šādu ID nav. Vispirms reģistrējiet to ar `POST /api/v1/files`. | | `422 unprocessable_entity` | Fails tika augšupielādēts citam target. Piemēram, `image` augšupielāde PDF QR kodam vai `pdf`, `image` vai `video` augšupielāde, kas izmantota kā vCard fotoattēls. | | `422 unprocessable_entity` | Fails ir reģistrēts, bet augšupielāde uz `uploadUrl` tā arī netika pabeigta. | Failu ID saturā (`fileId`, `pageLogoFileId`, `customItems[].logoFileId`, rindas `X-GETQR-*-FILEID`) netiek validēti. Tie tiek attēloti tikai tad, ja augšupielādēti ar target `logo`. QR kods tos piesaista sev, tāpēc tīrīšana tos neskar. ## Veida maiņa `qrType` varat mainīt ar [QR koda atjaunināšanu](https://docs.getqr.com/lv/api/endpoints/qr-codes.md#qr-koda-atjaunināšana). Sūtiet jaunajam veidam atbilstošu `data`: saglabātais saturs pieder vecajam veidam, tāpēc maiņa bez tā tiek noraidīta. Pēc atjaunināšanas mērķis tiek noteikts šādā secībā: 1. `vcard`, `social`, `multilink`, `event`: vienmēr mitinātā lapa. 2. Informācijas panelī izveidots PDF komplekts vai attēlu galerija: tā lapa. 3. `pdf`, `image`, `video`: faila URL (jauns `fileId`, citādi saglabātais). 4. `link.url`, ja nosūtīts. 5. Mainīts `data`. 6. Saglabātais URL. Ko dara katra maiņa: * **No `pdf`, `image` vai `video`.** Tiek notīrīts `fileId` un jebkurš komplekts vai galerija. * **Uz `pdf`, `image` vai `video`.** Nosūtiet arī `fileId`, citādi tiek atkārtoti izmantots saglabātais, kas var būt vCard fotoattēls. * **No `app`.** Tiek notīrīts lietotnes nosaukums, `link.ios` un `link.android`, tāpēc tālruņi seko jaunajam mērķim. * **Uz `wifi`.** Attēls pārslēdzas uz neapstrādātu saturu. Jau izdrukātie kodi joprojām satur īso saiti, kas tagad novirza uz `wifi:` URL. * **No `wifi`.** Izdrukātie kodi saglabā veco tīklu. * **Uz `vcard`, `social`, `multilink` vai `event`.** Īsā saite tiek novirzīta uz jauno mitināto lapu. * **No `vcard`, `social`, `multilink` vai `event`.** Sūtiet jaunu `data`. Mērķis seko tam. Informācijas panelī izveidotiem statiskiem QR kodiem nav īsās saites, tāpēc to `link.url` maiņa atgriež `422`. ## Nav pieejams API Šīs informācijas paneļa funkcijas nav daļa no v1 API. Nezināmi lauki tiek izmesti bez kļūdas, tāpēc to nosūtīšanai nav nekādas ietekmes. | Lauks | Apraksts | | - | - | | `appName` | Lietotnes saites QR koda attēlotais nosaukums. Ar API izveidotie lietotnes saites QR kodi informācijas paneļa sarakstā rāda sava veikala URL. | | `isStatic` | Statisks QR kods bez īsās saites. Katram ar API izveidotam QR kodam tāda ir, tāpēc to var rediģēt un izsekot pēc izdrukāšanas (izņemot `wifi`). | | `pdfBundle` | PDF QR kods ar diviem vai vairāk failiem. API izveido tikai viena faila PDF QR kodus. | | `imageGallery` | Image QR kods ar diviem vai vairāk attēliem. API izveido tikai viena attēla QR kodus. | Informācijas panelī izveidotus komplektus un galerijas joprojām var nolasīt, pauzēt un dzēst ar API, bet to failus ar API mainīt nevar. ## Biežākās problēmas > [accordion] 422 Invalid destination URL > > `link.url` izmanto shēmu, uz kuru īsā saite nevar novirzīt, piemēram, `geo:`, `smsto:`, `matmsg:` vai `tel:`. Izmantojiet šajā lapā norādītos formātus. > [accordion] 400 Missing destination URL > > `data` ir tukšs, un nav `link.url`. Veidam `app` iestatiet vismaz vienu no `link.ios`, `link.android`, `link.url` vai `data`. > [accordion] Atbildē data ir īsā saite, nevis mans URL > > Saišu veidiem saglabātais `data` ir īsā saite. Mērķi nolasiet no `url`. > [accordion] Galamērķa lapā trūkst informācijas no mana satura > > Lapa nolasa tikai tos laukus un rindu formas, kas norādītas šim veidam. Citi lauki tiek saglabāti, bet netiek rādīti. ## Kas tālāk > [card] [QR kodi](https://docs.getqr.com/lv/api/endpoints/qr-codes.md) > [card] [Faili](https://docs.getqr.com/lv/api/endpoints/files.md) > [card] [Pielāgošana](https://docs.getqr.com/lv/api/guides/customization.md) > [card] [Piekļuves noteikumi](https://docs.getqr.com/lv/api/guides/access-rules.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.