QR koda dati pēc veida

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. Sūtiet tos šādi:

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`	http(s) URL	Jā
`feedback`	Veidlapas http(s) URL	Jā
`payment`	Maksājumu pakalpojuma URL	Jā
`whatsapp`	`wa.me` saite	Jā
`location`	Kartes URL	Jā
`app`	Veikala URL vai tukšs, kā arī `link.ios` / `link.android`	Jā
`email`	`mailto:` URI	Jā
`sms`	`sms:` URI	Jā
`wifi`	`WIFI:` saturs	Nē
`pdf`, `image`, `video`	Tukšs, ar `fileId`	Jā
`vcard`	vCard 3.0 teksts	Jā
`social`	JSON virkne	Jā
`multilink`	JSON virkne	Jā
`event`	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.

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.

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.

Request body

{
  "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. data ir atsauksmju veidlapas http(s) URL, piemēram, Google Form vai atsauksmju lapa. Viss pārējais darbojas tāpat kā veidam Website.

Request body

{
  "qrType": "feedback",
  "data": "https://forms.gle/abc123"
}

Maksājums

qrType: "payment". Ceļvedis informācijas panelim: Maksājuma QR kods. data ir pakalpojuma sniedzēja maksājuma URL, piemēram:

https://paypal.me/<user>/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.

Request body

{
  "qrType": "payment",
  "data": "https://paypal.me/acme/25EUR"
}

qrType: "whatsapp". Ceļvedis informācijas panelim: WhatsApp QR kods. data ir wa.me saite: starptautisks numurs cipariem bez +, pēc izvēles ar iepriekš aizpildītu tekstu.

https://wa.me/<digits>
https://wa.me/<digits>?text=<urlencoded>

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.

Request body

{
  "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. data ir kartes URL. Izmantojiet šo formātu, lai QR kods paliktu rediģējams informācijas panelī (query_place_id nav obligāts):

https://www.google.com/maps/search/?api=1&query=<address>&query_place_coords=<lat>,<lng>&query_place_id=<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.

Request body

{
  "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.

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.

Request body

{
  "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.

mailto:<address>?subject=<subject>&body=<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.

Request body

{
  "qrType": "email",
  "data": "mailto:[email protected]?subject=Hello&body=Hi%20there"
}

Kļūdas:

422 Expected a mailto URI, e.g. "mailto:[email protected]?subject=Hello" for qrType "email".

SMS

qrType: "sms". Ceļvedis informācijas panelim: SMS QR kods.

sms:+<digits>
sms:+<digits>?body=<encodeURIComponent(text)>

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.

Request body

{
  "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.

WIFI:T:<WPA|WEP|nopass>;S:<ssid>;P:<password>;H:<true|false>;;

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.

Request body

{
  "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".

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, Image, Video.

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.

{
  "qrType": "pdf",
  "data": "",
  "fileId": "file_9f8e7d6c5b4a",
  "title": "Brochure"
}

{
  "qrType": "image",
  "data": "",
  "fileId": "file_3c2b1a0f9e8d",
  "title": "Floor plan"
}

{
  "qrType": "video",
  "data": "",
  "fileId": "file_5e4d3c2b1a0f",
  "title": "Product demo"
}

Kā augšupielādēt failu un iegūt tā fileId, skatiet Faili.

vCard

qrType: "vcard". Ceļvedis informācijas panelim: vCard QR kods.

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:<last>;<first>;;;: uzvārds un vārds. Veidotājs: abi obligāti, līdz 40 rakstzīmēm.
FN:<first> <last>: lapa to nenolasa. No tā tiek ņemts nosaukums informācijas paneļa sarakstā.
ORG:<company> un TITLE:<role>: 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:<email>: e-pasta adrese.
URL:<url>: tīmekļa vietne.
NOTE:<text>: kopsavilkums. Aizsargājiet \\, \n, \; un \,. Veidotājs: līdz 200 rakstzīmēm.
ADR:;;<street>;<city>;<state>;<zip>;<country>: adrese.
X-SOCIALPROFILE;TYPE=<platform>:<url> vai URL;TYPE=<PLATFORM>:<url>: sociālo tīklu saites, viena rinda katrai platformai.
PHOTO;VALUE=URI:<url>: profila attēla URL. Tam ir priekšroka pār jebkuru faila ID.
X-GETQR-IMAGE-FILEID:<fileId>: profila attēls (target logo).
X-GETQR-PAGE-LOGO-FILEID:<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.

Request body

{
  "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:[email protected]\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".

qrType: "social". Ceļvedis informācijas panelim: Social Media QR kods.

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

Request body

{
  "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.

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

Request body

{
  "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.

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

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

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

Request body

{
  "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, 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. 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ā:

vcard, social, multilink, event: vienmēr mitinātā lapa.
Informācijas panelī izveidots PDF komplekts vai attēlu galerija: tā lapa.
pdf, image, video: faila URL (jauns fileId, citādi saglabātais).
link.url, ja nosūtīts.
Mainīts data.
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

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.

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.

Atbildē data ir īsā saite, nevis mans URL

Saišu veidiem saglabātais data ir īsā saite. Mērķi nolasiet no url.

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.

API

QR koda dati pēc veida

Visi veidi īsumā

Kā QR kods novirza uz mērķi

Website

Atsauksmes

Maksājums

WhatsApp

Atrašanās vieta

Lietotnes saite

E-pasts

SMS

WiFi

PDF, Image un Video

vCard

Multi-Link

Pasākums

Faili QR kodos

Veida maiņa

Nav pieejams API

Biežākās problēmas

Kas tālāk

QR kodi

Faili

Pielāgošana

Piekļuves noteikumi

​Visi veidi īsumā

​Kā QR kods novirza uz mērķi

​Website

​Atsauksmes

​Maksājums

​WhatsApp

​Atrašanās vieta

​Lietotnes saite

​E-pasts

​SMS

​WiFi

​PDF, Image un Video

​vCard

​Social Media

​Multi-Link

​Pasākums

​Faili QR kodos

​Veida maiņa

​Nav pieejams API

​Biežākās problēmas

​Kas tālāk

QR kodi

Faili

Pielāgošana

Piekļuves noteikumi

Visi veidi īsumā

Kā QR kods novirza uz mērķi

Website

Atsauksmes

Maksājums

WhatsApp

Atrašanās vieta

Lietotnes saite

E-pasts

SMS

WiFi

PDF, Image un Video

vCard

Social Media

Multi-Link

Pasākums

Faili QR kodos

Veida maiņa

Nav pieejams API

Biežākās problēmas

Kas tālāk