Данные QR-кода по типам

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

​

Все типы кратко

​

Как QR-код ведёт к адресу назначения

• Значения по умолчанию. При создании пропущенный или пустой link.url становится равным data, и весь объект link можно не передавать. Если переданы оба и они различаются, приоритет у link.url. Передавайте их одинаковыми или только data.
• Что кодирует изображение. Для всех типов, кроме wifi, изображение кодирует короткую ссылку. Поэтому адрес назначения напечатанного кода можно менять, а его сканирования отслеживаются. QR-код WiFi кодирует саму сеть: после печати его нельзя изменить, и его сканирования не отслеживаются.
• Схемы. link.url принимает только http:, https:, wifi:, mailto:, sms: и begin:. Всё остальное, включая geo:, smsto:, matmsg: и tel:, получает 422 Invalid destination URL, даже если data это принимает.
• Пустые данные. Пустое data пропускает проверку типа. Тогда для типа с перенаправлением должен быть задан link.url, иначе вызов получит 400 Missing destination URL.
• Структура. Помимо проверки типа, сервер данные не валидирует. Для JSON-типа достаточно, чтобы строка разбиралась как JSON-объект, а vCard должна лишь начинаться с BEGIN:VCARD.

​

Website

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

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

​

Feedback

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

​

Payment

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

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

​

WhatsApp

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

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

​

Location

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

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

• 422 Invalid URL
• 400 Missing destination URL

​

Email

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

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

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

​

SMS

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

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

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

​

WiFi

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

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

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

​

PDF, Image и Video

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

​

vCard

• N:<last>;<first>;;;: фамилия и имя. Конструктор: оба обязательны, до 40 символов.
• FN:<first> <last>: страница его не читает. Из него берётся подпись в списке панели управления.
• ORG:<company> и TITLE:<role>: компания и должность. Конструктор: до 40 символов.
• TEL;TYPE=HOME:, TEL;TYPE=CELL:, TEL;TYPE=WORK:, TEL;TYPE=FAX:: номера телефона, мобильного, рабочего и факса (+ и цифры).
• EMAIL:<email>: адрес электронной почты.
• URL:<url>: сайт.
• NOTE:<text>: описание. Экранируйте \\, \n, \; и \,. Конструктор: до 200 символов.
• ADR:;;<street>;<city>;<state>;<zip>;<country>: адрес.
• X-SOCIALPROFILE;TYPE=<platform>:<url> или URL;TYPE=<PLATFORM>:<url>: ссылки на соцсети, по одной строке на платформу.
• PHOTO;VALUE=URI:<url>: URL изображения профиля. Имеет приоритет над любым ID файла.
• X-GETQR-IMAGE-FILEID:<fileId>: изображение профиля (target logo).
• X-GETQR-PAGE-LOGO-FILEID:<fileId>: логотип страницы (target logo).
• X-GETQR-LANDING-THEME:p|<0-4> или X-GETQR-LANDING-THEME:c|#RRGGBB|#RRGGBB|#RRGGBB: тема лендинга — либо индекс готовой темы (от 0 до 4), либо свои цвета фона, кнопок и иконок.

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

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

​

Social Media

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

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

​

Multi-Link

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

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

​

Event

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

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

​

Файлы в QR-кодах

• pdf, image, video. Содержимое QR-кода PDF, Image или Video.
• logo. Изображения профиля, логотипы страниц, иконки своих ссылок и логотипы в центре кода.

​

Смена типа

1. vcard, social, multilink, event: всегда размещённая страница.
2. Набор PDF или галерея изображений, созданные в панели управления: их лендинг.
3. pdf, image, video: URL файла (новый fileId, иначе сохранённый).
4. link.url, если передан.
5. Изменённое data.
6. Сохранённый URL.

• Из pdf, image или video. fileId, а также набор или галерея очищаются.
• В pdf, image или video. Передайте и fileId, иначе будет повторно использован сохранённый, а это может быть фото vCard.
• Из app. Название приложения, link.ios и link.android очищаются, поэтому телефоны переходят на новый адрес назначения.
• В wifi. Изображение начинает кодировать исходные данные. Уже напечатанные коды по-прежнему содержат короткую ссылку, которая теперь перенаправляет на URL wifi:.
• Из wifi. Напечатанные коды сохраняют старую сеть.
• В vcard, social, multilink или event. Короткая ссылка начинает вести на новую размещённую страницу.
• Из vcard, social, multilink или event. Передайте новое data. Адрес назначения определяется по нему.

​

Не поддерживается в API

​

Частые проблемы

​

Что дальше