Türe göre QR kodu verileri

GetQR API’si beta aşamasındadır ve seçili çalışma alanlarında kullanılabilir. Ayrıntılar genel sürümden önce değişebilir.

Her QR kodunun bir qrType değeri vardır ve tür, data alanının ne içermesi gerektiğini belirler. Bu kılavuz her türün biçimini, çalışan bir istek gövdesini ve kod basıldıktan sonra neleri değiştirebileceğinizi listeler. Örnekler, QR kodu oluşturma için istek gövdeleridir. Bunları şöyle gönderin:

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

Tüm türlere genel bakış

`qrType`	`data`	Baskıdan sonra düzenlenebilir
`website`	http(s) URL’si	Evet
`feedback`	Formun http(s) URL’si	Evet
`payment`	Ödeme sağlayıcısı URL’si	Evet
`whatsapp`	`wa.me` bağlantısı	Evet
`location`	Harita URL’si	Evet
`app`	Mağaza URL’si veya boş, ayrıca `link.ios` / `link.android`	Evet
`email`	`mailto:` URI’si	Evet
`sms`	`sms:` URI’si	Evet
`wifi`	`WIFI:` verisi	Hayır
`pdf`, `image`, `video`	Boş, bir `fileId` ile	Evet
`vcard`	vCard 3.0 metni	Evet
`social`	JSON dizesi	Evet
`multilink`	JSON dizesi	Evet
`event`	JSON dizesi	Evet

QR kodu nasıl çözümlenir

Her QR kodu bir kısa bağlantı ve bir veri yükünden oluşur. İçeriği iki alan taşır:

Alan	Nedir
`link.url`	Kısa bağlantının ziyaretçiyi gönderdiği yer. `wifi` dışındaki tüm türler için gerçek hedef budur.
`data`	Türün veri yükü; `qrType` değerine göre kontrol edilir. Yalnızca `wifi`, `vcard`, `social`, `multilink`, `event` ve `sms` için gönderildiği gibi saklanır. Diğer tüm türlerde yalnızca `link.url` değerini sağlar ve saklanan `data` kısa bağlantıya dönüşür. Hedefi yanıttaki `url` alanından okuyun.

Tüm türler için kurallar:

Varsayılanlar. Oluştururken, gönderilmeyen veya boş bir link.url değeri data olur ve link nesnesinin tamamını göndermeyebilirsiniz. İkisi de gönderilir ve farklı olursa link.url önceliklidir. İkisini aynı gönderin veya yalnızca data gönderin.
Görselin kodladığı şey. Görsel, wifi dışındaki tüm türlerde kısa bağlantıyı kodlar. Böylece basılı bir kodun nereye yönlendireceğini değiştirebilirsiniz ve taramaları izlenir. WiFi QR kodu ise ağın kendisini kodlar: baskıdan sonra değiştirilemez ve taramaları izlenmez.
Şemalar. link.url yalnızca http:, https:, wifi:, mailto:, sms: ve begin: kabul eder. geo:, smsto:, matmsg: ve tel: dahil diğer her şey, data kabul etse bile 422 Invalid destination URL alır.
Boş veri. Boş bir data, tür kontrolünü atlar. Yönlendirme türlerinde bu durumda link.url ayarlanmış olmalıdır; aksi hâlde çağrı 400 Missing destination URL alır.
Yapı. Sunucu, tür kontrolünün ötesinde veri yükünü doğrulamaz. JSON türünün yalnızca bir JSON nesnesi olarak ayrıştırılabilmesi, vCard’ın ise yalnızca BEGIN:VCARD ile başlaması gerekir.

Aşağıda Düzenleyici olarak işaretlenen sınırlar, panel düzenleyicisinin uyguladığı sınırlardır. API bu sınırlara uymayan veri yüklerini de kabul eder, ancak bunlar açılış sayfasında veya düzenleyicide tuhaf görünebilir.

Website

qrType: "website". Panel kılavuzu: Website QR kodu.

Alan	Davranış
`data`	Bir http(s) URL’si.
`link.url`	Hedef. Varsayılanı `data`.
`fileId`	İzin verilmez.
Kodladığı	`link.url` adresine yönlendiren kısa bağlantı. Taramalar izlenir.
Baskıdan sonra	Düzenlenebilir. Hedefi değiştirmek için `data` veya `link.url` gönderin. Yalnızca `data` yeterlidir.

Request body

{
  "qrType": "website",
  "data": "https://example.com/menu",
  "title": "Menu"
}

Hatalar:

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

Geri Bildirim

qrType: "feedback". Panel kılavuzu: Geri Bildirim QR kodu. data, geri bildirim formunun http(s) URL’sidir; örneğin bir Google Form veya bir değerlendirme sayfası. Geri kalan her şey Website türündeki gibi çalışır.

Request body

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

Ödeme

qrType: "payment". Panel kılavuzu: Ödeme QR kodu. data, sağlayıcının ödeme URL’sidir; örneğin:

https://paypal.me/<user>/25EUR

Panel düzenleyicisi şu alan adlarını tanır: paypal.me, paypal.com/paypalme, cash.app, venmo.com, buy.stripe.com, stripe.com, square.link ve payoneer.com. PayPal’da tutar, yolun son bölümüdür. Diğer http(s) URL’leri de çalışır, ancak düzenleyici bunları sağlayıcı ve tutar olarak ayırmaz. Geri kalan her şey Website türündeki gibi çalışır.

Request body

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

qrType: "whatsapp". Panel kılavuzu: WhatsApp QR kodu. data bir wa.me bağlantısıdır: + olmadan rakamlarla uluslararası numara, isteğe bağlı olarak önceden doldurulmuş bir metinle.

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

Sunucu yalnızca bir http(s) URL’si olup olmadığını kontrol eder. Panel api.whatsapp.com/send bağlantılarını da okur. Geri kalan her şey Website türündeki gibi çalışır.

Request body

{
  "qrType": "whatsapp",
  "data": "https://wa.me/14155550123?text=Hi%20there"
}

Konum

qrType: "location". Panel kılavuzu: Konum QR kodu. data bir harita URL’sidir. QR kodunun panelde düzenlenebilir kalması için şu biçimi kullanın (query_place_id isteğe bağlıdır):

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

Diğer http(s) URL’leri de yönlendirir. Bir geo: URI’si data kontrolünden geçer ancak hedef olarak reddedilir; bu yüzden kullanmayın. Geri kalan her şey Website türündeki gibi çalışır.

Request body

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

Uygulama Bağlantısı

qrType: "app". Panel kılavuzu: Uygulama Bağlantısı QR kodu.

Alan	Davranış
`link.ios`, `link.android`	App Store ve Google Play URL’leri. iOS ziyaretçileri `ios`, Android ziyaretçileri `android` adresine gider. Tarama sırasında diğer her şeyden önceliklidir.
`link.url`	Diğer cihazlar için yedek hedef. Varsayılanı `data`, ardından `ios` veya `android`.
`data`	Bir http(s) URL’si (panel mağaza URL’sini gönderir) veya boş. `link.ios`, `link.android`, `link.url` veya `data` alanlarından en az biri ayarlanmış olmalıdır; aksi hâlde çağrı `400 Missing destination URL` alır.
`fileId`	İzin verilmez.
Kodladığı	Kısa bağlantı. Taramalar izlenir.
Baskıdan sonra	Düzenlenebilir. `link.ios` ve `link.android` birbirinden bağımsız olarak, yalnızca gönderildiklerinde uygulanır. `null` birini temizler. `qrType` değerini yeniden göndermeniz gerekmez. Başka bir türe geçmek iki mağaza bağlantısını da temizler.

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

Hatalar:

422 Invalid URL
400 Missing destination URL

E-posta

qrType: "email". Panel kılavuzu: E-posta QR kodu.

mailto:<address>?subject=<subject>&body=<body>

Alan	Davranış
`data`	İsteğe bağlı konu ve gövde içeren bir `mailto:` URI’si. Boşlukları `%20` olarak kodlayın: panel bunları `+` olarak yazar ve her e-posta uygulaması bunu boşluk olarak okumaz. `matmsg:` hedef olarak reddedilir.
`link.url`	`mailto:` URI’si. Varsayılanı `data`.
`fileId`	İzin verilmez.
Kodladığı	E-posta uygulamasına yönlendiren bir sayfa açan kısa bağlantı.
Baskıdan sonra	Düzenlenebilir. Mesajı değiştirmek için `data` veya `link.url` gönderin. Yalnızca `data` yeterlidir.

Request body

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

Hatalar:

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

SMS

qrType: "sms". Panel kılavuzu: SMS QR kodu.

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

Alan	Davranış
`data`	İsteğe bağlı gövde içeren bir `sms:` URI’si. Panel yalnızca tam olarak bu biçimi okur. `smsto:` hedef olarak reddedilir.
`link.url`	`sms:` URI’si. Varsayılanı `data`.
`fileId`	İzin verilmez.
Kodladığı	Mesajlaşma uygulamasına yönlendiren bir sayfa açan kısa bağlantı.
Baskıdan sonra	Düzenlenebilir. Mesajı değiştirmek için `data` veya `link.url` gönderin. Yalnızca `data` yeterlidir.

Request body

{
  "qrType": "sms",
  "data": "sms:+14155550123?body=Table%2012"
}

Hatalar:

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

WiFi

qrType: "wifi". Panel kılavuzu: WiFi QR kodu.

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

Alan	Davranış
`data`	Zorunlu. `T`, `S`, `P`, `H` sırasını koruyun: panel düzenleyicisi ve liste buna bağlıdır. SSID ve paroladaki `\`, `;`, `"` ve `:` karakterlerini ters eğik çizgiyle kaçışlayın. Açık bir ağ için boş bir `P:` ile `T:nopass` kullanın. Tarayıcılar `T:none` değerini reddeder. Düzenleyici: SSID zorunlu, `nopass` değilse parola en az 8 karakter.
`link.url`	Tarama için kullanılmaz. Varsayılanı `data`.
`fileId`	İzin verilmez.
Kodladığı	Kısa bağlantı değil, ham `WIFI:` verisi. Taramalar izlenmez.
Baskıdan sonra	Düzenlenemez. Yeni bir `data` yalnızca sonraki indirmeleri değiştirir. Basılı kodlar eski ağı korur.

Request body

{
  "qrType": "wifi",
  "data": "WIFI:T:WPA;S:Cafe Guest;P:espresso42;H:false;;"
}

Hatalar:

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

Basılı bir WiFi QR kodunun türünü değiştirmeyin. Basılı kodlar eski ağı korur.

PDF, görsel ve video

qrType: "pdf", "image" veya "video". Panel kılavuzları: PDF, Image, Video.

Alan	Davranış
`fileId`	Dosya. Dosyayı türle eşleşen hedefle yükleyin: `pdf`, `image` veya `video`. Bir `fileId` olduğunda `link.url` dosyanın URL’si olur ve bu alana gönderdiğiniz her şey yok sayılır.
`data`	Başka bir türün veri yükü (`WIFI:`, `BEGIN:VCARD`, `sms:`, `mailto:`, bir JSON nesnesi) dışında herhangi bir şey. Boş olabilir.
`link.url`	`fileId` olmadan `link.url` (veya `data`) harici bir hedef olarak kullanılır. Bu çalışır, ancak panel herhangi bir dosya göstermez.
Kodladığı	Doğrudan dosyaya yönlendiren kısa bağlantı. PDF, bir görüntüleyici sayfasında değil ham dosya olarak açılır.
Baskıdan sonra	Düzenlenebilir. Dosyayı değiştirmek için yeni bir `fileId` gönderin. Eski dosya serbest bırakılır.

QR kodu başına bir dosya: PDF paketleri ve görsel galerileri API’de kullanılamaz. Bkz. API üzerinden desteklenmeyenler.

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

Dosyayı yüklemek ve fileId değerini almak için bkz. Dosyalar.

vCard

qrType: "vcard". Panel kılavuzu: vCard QR kodu.

Alan	Davranış
`data`	Zorunlu. `BEGIN:VCARD` ile başlayan, satırları `\r\n` ile ayrılmış vCard 3.0 metni (`\n` de çalışır).
`fileId`	İsteğe bağlı profil görseli (`logo` hedefi); `data` içinde `PHOTO` veya `X-GETQR-IMAGE-FILEID` satırı yoksa kullanılır.
`link.url`	Yok sayılır ve barındırılan sayfayla değiştirilir. Göndermeyin.
Kodladığı	Kişiyi kaydetme (`.vcf`) indirmesi sunan, barındırılan kişi sayfasını açan kısa bağlantı.
Baskıdan sonra	Düzenlenebilir. Sayfayı güncellemek için yeni bir `data` gönderin.

Açılış sayfası ve düzenleyici yalnızca aşağıdaki satır biçimlerini okur. TEL;CELL: veya EMAIL;TYPE=INTERNET: gibi diğer varyantlar saklanır ancak sayfada görünmez.

N:<last>;<first>;;;: soyadı ve ad. Düzenleyici: ikisi de zorunlu, en fazla 40 karakter.
FN:<first> <last>: sayfa tarafından okunmaz. Panel listesindeki etiket buradan gelir.
ORG:<company> ve TITLE:<role>: şirket ve unvan. Düzenleyici: en fazla 40 karakter.
TEL;TYPE=HOME:, TEL;TYPE=CELL:, TEL;TYPE=WORK:, TEL;TYPE=FAX:: telefon, cep, iş ve faks numaraları (+ ve rakamlar).
EMAIL:<email>: e-posta adresi.
URL:<url>: web sitesi.
NOTE:<text>: özet. \\, \n, \; ve \, kaçışlarını kullanın. Düzenleyici: en fazla 200 karakter.
ADR:;;<street>;<city>;<state>;<zip>;<country>: adres.
X-SOCIALPROFILE;TYPE=<platform>:<url> veya URL;TYPE=<PLATFORM>:<url>: sosyal bağlantılar, platform başına bir satır.
PHOTO;VALUE=URI:<url>: profil görseli URL’si. Tüm dosya kimliklerine göre önceliklidir.
X-GETQR-IMAGE-FILEID:<fileId>: profil görseli (logo hedefi).
X-GETQR-PAGE-LOGO-FILEID:<fileId>: sayfa logosu (logo hedefi).
X-GETQR-LANDING-THEME:p|<0-4> veya X-GETQR-LANDING-THEME:c|#RRGGBB|#RRGGBB|#RRGGBB: açılış sayfası teması; ya bir ön ayar dizini (0–4) ya da özel arka plan, düğme ve simge renkleri.

Sosyal platformlar: 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"
}

Hatalar:

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

qrType: "social". Panel kılavuzu: Social Media QR kodu.

Alan	Davranış
`data`	Zorunlu. Bir nesneyi kodlayan JSON dizesi. `JSON.stringify` ile oluşturun.
`fileId`	İsteğe bağlı üst düzey profil görseli (`logo` hedefi).
`link.url`	Yok sayılır ve barındırılan sayfayla değiştirilir. Göndermeyin.
Kodladığı	Barındırılan sosyal medya sayfasını açan kısa bağlantı.
Baskıdan sonra	Düzenlenebilir. Sayfayı güncellemek için yeni bir `data` gönderin.

data alanları:

Alan	Tür	Notlar
`firstName`	string	Sayfa başlığı ve gösterilen tek ad. Düzenleyici: zorunlu, en fazla 40.
`lastName`	string	En fazla 40. Sayfada gösterilmez.
`summary`	string	En fazla 200.
`socialLinks`	`{ platform, url }[]`	`platform`, vCard sosyal platformlarından biridir. Düzenleyici: her platform bir kez.
`customItems`	`{ name, url, logoFileId }[]`	Düzenleyici: en fazla 40 karakterlik `name`, bir http(s) `url` ve bir `logoFileId`. Toplamda en az bir sosyal bağlantı veya özel öğe.
`fileId`	string	Profil görseli (`logo` hedefi). Üst düzey `fileId` yedektir.
`imageUrl`	string	Harici profil görseli URL’si; yalnızca dosya kimliği yoksa kullanılır.
`pageLogoFileId`	string	Sayfa logosu (`logo` hedefi).
`landingThemeMode`	`"preset" \| "custom"`	Varsayılanı `preset`.
`landingPresetIndex`	0–4	Varsayılanı 0.
`landingCustomBg`, `landingCustomButton`, `landingCustomIcon`	`#RRGGBB`	Mod `custom` olduğunda kullanılır.

Request body

{
  "qrType": "social",
  "data": "{\"firstName\":\"Acme Coffee\",\"summary\":\"Follow us\",\"socialLinks\":[{\"platform\":\"instagram\",\"url\":\"https://instagram.com/acme\"}],\"customItems\":[]}"
}

Hatalar:

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

Çoklu Bağlantı

qrType: "multilink". Panel kılavuzu: Çoklu Bağlantı QR kodu.

Alan	Davranış
`data`	Zorunlu. Bir nesneyi kodlayan JSON dizesi.
`fileId`	İsteğe bağlı üst düzey profil görseli (`logo` hedefi).
`link.url`	Yok sayılır ve barındırılan sayfayla değiştirilir. Göndermeyin.
Kodladığı	Barındırılan çoklu bağlantı sayfasını açan kısa bağlantı.
Baskıdan sonra	Düzenlenebilir. Sayfayı güncellemek için yeni bir `data` gönderin.

data alanları Social Media ile aynıdır; tek fark firstName, lastName ve summary yerine şunların gelmesidir:

Alan	Tür	Notlar
`title`	string	Sayfa başlığı. Düzenleyici: zorunlu, en fazla 40.
`description`	string	En fazla 200.

customItems içinde logoFileId isteğe bağlıdır: yedek bir simge gösterilir. Düzenleyici: en az bir sosyal bağlantı veya boş olmayan bir özel öğe.

Request body

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

Hatalar:

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

Event

qrType: "event". Panel kılavuzu: Event QR kodu.

Alan	Davranış
`data`	Zorunlu. Bir nesneyi kodlayan JSON dizesi. Bilinmeyen veya geçersiz değerler varsayılanlara döner.
`fileId`	Doğrulanır (`logo` hedefi) ve saklanır, ancak etkinlik sayfası kapak görselini yalnızca `data.fileId` alanından okur. Kapak kimliğini veri yüküne koyun.
`link.url`	Yok sayılır ve barındırılan sayfayla değiştirilir. Göndermeyin.
Kodladığı	`.ics` indirmesi sunan, barındırılan etkinlik sayfasını açan kısa bağlantı.
Baskıdan sonra	Düzenlenebilir. Sayfayı güncellemek için yeni bir `data` gönderin.

data alanları:

Alan	Tür	Notlar
`name`	string	Düzenleyici: zorunlu.
`eventType`	string	Aşağıdaki etkinlik türlerinden biri veya boş.
`start`, `end`	`"YYYY-MM-DDTHH:mm"`	`timezone` içindeki yerel saat. Düzenleyici: ikisi de zorunlu, bitiş başlangıçtan sonra.
`timezone`	IANA, örneğin `"Europe/Berlin"`	Başlangıç ve bitişi `.ics` dosyasında konumlandırır. Her zaman gönderin: boş veya bilinmeyen bir saat dilimi, `.ics` dosyasının saatleri UTC olarak yorumlamasına neden olur.
`street`, `zip`, `city`, `state`, `country`	string	Düzenleyici: `city` ve `country` zorunlu, her biri en fazla 40.
`facilities`	string[]	Aşağıdaki listeden kimlikler. Bilinmeyen kimlikler atılır.
`notes`	string	Serbest metin.
`fileId`	string	Kapak görseli (`logo` hedefi).
`pageLogoFileId`	string	Sayfa logosu (`logo` hedefi).
`organizerName`, `organizerEmail`, `mobile`, `work`	string	`mobile` ve `work` en fazla 40.
`socialLinks`	`{ platform, url }[]`	vCard sosyal platformları ve ek olarak `website`.
`ticketsUrl`	http(s) URL	Bilet satın alma bağlantısı.
`ticketsLabel`	string	En fazla 20 karakter. Daha uzun etiketler kesilir. Boş bırakılırsa varsayılan etiket gösterilir.

Etkinlik türleri

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

Olanaklar

Grup	Kimlikler
Giriş	`freeEntry`, `idRequired`, `invitationOnly`, `plusOneAllowed`, `reEntryAllowed`
Yaş (birini seçin)	`adultsOnly`, `age18Plus`, `age21Plus`, `kidsWelcome`
Mekânda	`parking`, `publicTransport`, `shuttle`, `wheelchairAccess`, `evCharging`, `wifi`, `foodDrinks`, `alcoholServed`, `atm`, `coatCheck`, `pool`, `phoneCharging`, `firstAid`, `wc`
Kurallar	`petsAllowed`, `noPets`, `smokingArea`, `noSmoking`, `noPhotos`
Kıyafet kuralı (birini seçin)	`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\"}"
}

Hatalar:

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

QR kodlarında dosyalar

Bir dosyayı Dosyalar ile kaydedin, yükleyin ve ardından fileId değerini gönderin. Kullanım amacına uygun hedefi seçin:

pdf, image, video. PDF, görsel veya video QR kodunun içeriği.
logo. Profil görselleri, sayfa logoları, özel bağlantı simgeleri ve orta logolar.

Hiçbir QR koduna eklenmeyen dosyalar bir bekleme süresinden sonra silinir. Oluştururken ve fileId gönderildiğinde PATCH isteğinde döndürülen fileId hataları:

Durum	Neden
`422 unprocessable_entity`	Tür dosya almıyor. Yalnızca `pdf`, `image`, `video`, `vcard`, `social`, `multilink` ve `event` dosya kabul eder.
`404 not_found`	Bu kimliğe sahip dosya yok. Önce `POST /api/v1/files` ile kaydedin.
`422 unprocessable_entity`	Dosya farklı bir hedef için yüklenmiş. Örneğin bir PDF QR kodunda `image` yüklemesi veya vCard fotoğrafı olarak kullanılan bir `pdf`, `image` ya da `video` yüklemesi.
`422 unprocessable_entity`	Dosya kayıtlı ancak `uploadUrl` adresine yükleme hiç tamamlanmamış.

Veri yükü içindeki dosya kimlikleri (fileId, pageLogoFileId, customItems[].logoFileId, X-GETQR-*-FILEID satırları) doğrulanmaz. Yalnızca logo hedefiyle yüklendiklerinde görüntülenirler. QR kodu bunları sahiplenir, bu nedenle temizleme işlemi onlara dokunmaz.

Tür değiştirme

qrType değerini QR kodunu güncelleme ile değiştirebilirsiniz. Yeni türle eşleşen bir data gönderin: saklanan veri yükü eski türe aittir, bu yüzden yeni veri gönderilmeden yapılan tür değişikliği reddedilir. Bir güncellemeden sonra hedef şu sırayla belirlenir:

vcard, social, multilink, event: her zaman barındırılan sayfa.
Panelde oluşturulmuş bir PDF paketi veya görsel galerisi: açılış sayfası.
pdf, image, video: dosya URL’si (yeni bir fileId, yoksa kayıtlı olan).
Gönderildiyse link.url.
Değişen data.
Kayıtlı URL.

Her tür değişikliğinin etkisi:

pdf, image veya video türünden çıkış. fileId ve varsa paket veya galeri temizlenir.
pdf, image veya video türüne geçiş. fileId de gönderin; aksi hâlde kayıtlı olan yeniden kullanılır ve bu bir vCard fotoğrafı olabilir.
app türünden çıkış. Uygulama adı, link.ios ve link.android temizlenir; böylece telefonlar yeni hedefi izler.
wifi türüne geçiş. Görsel ham veri yüküne geçer. Önceden basılmış kodlar hâlâ kısa bağlantıyı taşır ve bu bağlantı artık bir wifi: URL’sine yönlendirir.
wifi türünden çıkış. Basılı kodlar eski ağlarını korur.
vcard, social, multilink veya event türüne geçiş. Kısa bağlantı yeni barındırılan sayfaya yönlendirilir.
vcard, social, multilink veya event türünden çıkış. Yeni data değerini gönderin. Hedef onu izler.

Panelde oluşturulan statik QR kodlarının kısa bağlantısı yoktur; bu nedenle link.url değerlerini değiştirmek 422 döndürür.

API üzerinden desteklenmeyenler

Bu panel özellikleri v1 API’sinin parçası değildir. Bilinmeyen alanlar hata verilmeden atılır, bu yüzden bunları göndermenin bir etkisi olmaz.

Alan	Açıklama
`appName`	Uygulama Bağlantısı QR kodunun görünen adı. API ile oluşturulan Uygulama Bağlantısı QR kodları panel listesinde mağaza URL’lerini gösterir.
`isStatic`	Kısa bağlantısı olmayan statik bir QR kodu. API’nin oluşturduğu her QR kodunun bir kısa bağlantısı vardır; böylece baskıdan sonra düzenlenebilir ve izlenebilir (`wifi` hariç).
`pdfBundle`	İki veya daha fazla dosya içeren bir PDF QR kodu. API yalnızca tek dosyalı PDF QR kodları oluşturur.
`imageGallery`	İki veya daha fazla görsel içeren bir Image QR kodu. API yalnızca tek görselli QR kodları oluşturur.

Panelde oluşturulan paketler ve galeriler API üzerinden okunabilir, duraklatılabilir ve silinebilir, ancak dosyaları API üzerinden değiştirilemez.

Sık karşılaşılan sorunlar

422 Invalid destination URL

link.url, kısa bağlantının yönlendiremeyeceği bir şema kullanıyor; örneğin geo:, smsto:, matmsg: veya tel:. Bu sayfadaki biçimleri kullanın.

400 Missing destination URL

data boş ve link.url yok. app için link.ios, link.android, link.url veya data alanlarından en az birini ayarlayın.

Yanıttaki data benim URL'im değil, bir kısa bağlantı

Bağlantı türlerinde saklanan data kısa bağlantıdır. Hedefi url alanından okuyun.

Açılış sayfasında veri yükümdeki bazı ayrıntılar eksik

Sayfa yalnızca tür için listelenen alanları ve satır biçimlerini okur. Diğer alanlar saklanır ancak gösterilmez.

API

Türe göre QR kodu verileri

Tüm türlere genel bakış

QR kodu nasıl çözümlenir

Website

Geri Bildirim

Ödeme

WhatsApp

Konum

Uygulama Bağlantısı

E-posta

SMS

WiFi

PDF, görsel ve video

vCard

Çoklu Bağlantı

Event

QR kodlarında dosyalar

Tür değiştirme

API üzerinden desteklenmeyenler

Sık karşılaşılan sorunlar

Sırada ne var

QR kodları

Dosyalar

Özelleştirme

Erişim kuralları

​Tüm türlere genel bakış

​QR kodu nasıl çözümlenir

​Website

​Geri Bildirim

​Ödeme

​WhatsApp

​Konum

​Uygulama Bağlantısı

​E-posta

​SMS

​WiFi

​PDF, görsel ve video

​vCard

​Social Media

​Çoklu Bağlantı

​Event

​QR kodlarında dosyalar

​Tür değiştirme

​API üzerinden desteklenmeyenler

​Sık karşılaşılan sorunlar

​Sırada ne var

QR kodları

Dosyalar

Özelleştirme

Erişim kuralları

Tüm türlere genel bakış

QR kodu nasıl çözümlenir

Website

Geri Bildirim

Ödeme

WhatsApp

Konum

Uygulama Bağlantısı

E-posta

SMS

WiFi

PDF, görsel ve video

vCard

Social Media

Çoklu Bağlantı

Event

QR kodlarında dosyalar

Tür değiştirme

API üzerinden desteklenmeyenler

Sık karşılaşılan sorunlar

Sırada ne var