Données des QR codes par type

L’API GetQR est en version bêta et réservée à certains espaces de travail. Certains détails peuvent changer avant la disponibilité générale.

Chaque QR code a un qrType, et ce type détermine ce que data doit contenir. Ce guide présente le format de chaque type, un corps de requête qui fonctionne, et ce que vous pouvez encore modifier une fois le code imprimé. Les exemples sont des corps de requête pour Créer un QR code. Envoyez-les ainsi :

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

Aperçu de tous les types

`qrType`	`data`	Modifiable après impression
`website`	URL http(s)	Oui
`feedback`	URL http(s) du formulaire	Oui
`payment`	URL du prestataire de paiement	Oui
`whatsapp`	Lien `wa.me`	Oui
`location`	URL de carte	Oui
`app`	URL de store ou vide, plus `link.ios` / `link.android`	Oui
`email`	URI `mailto:`	Oui
`sms`	URI `sms:`	Oui
`wifi`	Payload `WIFI:`	Non
`pdf`, `image`, `video`	Vide, avec un `fileId`	Oui
`vcard`	Texte vCard 3.0	Oui
`social`	Chaîne JSON	Oui
`multilink`	Chaîne JSON	Oui
`event`	Chaîne JSON	Oui

Comment un QR code est résolu

Chaque QR code est un lien court associé à un payload. Deux champs portent le contenu :

Champ	Ce que c’est
`link.url`	L’endroit où le lien court envoie le visiteur. C’est la vraie destination pour tous les types sauf `wifi`.
`data`	Le payload du type, vérifié selon `qrType`. Il n’est stocké tel quel que pour `wifi`, `vcard`, `social`, `multilink`, `event` et `sms`. Pour tous les autres types, il sert seulement à renseigner `link.url`, et la valeur `data` stockée devient le lien court. Lisez la destination dans `url` de la réponse.

Règles valables pour tous les types :

Valeurs par défaut. À la création, un link.url omis ou vide prend la valeur de data, et vous pouvez omettre tout l’objet link. Si les deux sont envoyés et diffèrent, link.url l’emporte. Envoyez-les identiques, ou n’envoyez que data.
Ce qu’encode l’image. L’image encode le lien court pour tous les types sauf wifi. Vous pouvez donc changer la destination d’un code imprimé, et ses scans sont suivis. Un QR code WiFi encode le réseau lui-même : vous ne pouvez pas le modifier après impression, et ses scans ne sont pas suivis.
Schémas. link.url n’accepte que http:, https:, wifi:, mailto:, sms: et begin:. Tout autre schéma, y compris geo:, smsto:, matmsg: et tel:, renvoie 422 Invalid destination URL, même là où data l’accepte.
Données vides. Un data vide saute la vérification du type. Pour un type de redirection, link.url doit alors être défini, sinon l’appel renvoie 400 Missing destination URL.
Structure. Au-delà de la vérification du type, le serveur ne valide pas le payload. Un type JSON doit seulement être analysable comme un objet JSON, et une vCard doit seulement commencer par BEGIN:VCARD.

Les limites marquées Builder ci-dessous sont celles qu’applique l’éditeur du tableau de bord. L’API accepte des payloads qui les ignorent, mais ils peuvent s’afficher bizarrement sur la page de destination ou dans l’éditeur.

Website

qrType : "website". Guide du tableau de bord : QR code Website.

Champ	Comportement
`data`	Une URL http(s).
`link.url`	La destination. Par défaut `data`.
`fileId`	Non autorisé.
Encode	Le lien court, qui redirige vers `link.url`. Les scans sont suivis.
Après impression	Modifiable. Envoyez `data` ou `link.url` pour changer la destination. `data` seul suffit.

Request body

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

Erreurs :

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

Feedback

qrType : "feedback". Guide du tableau de bord : QR code Feedback. data est l’URL http(s) du formulaire d’avis, par exemple un Google Form ou une page d’avis. Tout le reste fonctionne comme pour Website.

Request body

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

Payment

qrType : "payment". Guide du tableau de bord : QR code Payment. data est l’URL de paiement du prestataire, par exemple :

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

L’éditeur du tableau de bord reconnaît ces hôtes : paypal.me, paypal.com/paypalme, cash.app, venmo.com, buy.stripe.com, stripe.com, square.link et payoneer.com. Pour PayPal, le montant est le dernier segment du chemin. Toute autre URL http(s) fonctionne aussi, mais l’éditeur ne la décompose pas en prestataire et montant. Tout le reste fonctionne comme pour Website.

Request body

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

qrType : "whatsapp". Guide du tableau de bord : QR code WhatsApp. data est un lien wa.me : le numéro international en chiffres sans +, éventuellement avec un texte prérempli.

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

Le serveur vérifie seulement qu’il s’agit d’une URL http(s). Le tableau de bord lit aussi les liens api.whatsapp.com/send. Tout le reste fonctionne comme pour Website.

Request body

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

Location

qrType : "location". Guide du tableau de bord : QR code Location. data est une URL de carte. Utilisez ce format pour que le QR code reste modifiable dans le tableau de bord (query_place_id est facultatif) :

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

Toute autre URL http(s) redirige aussi. Une URI geo: passe la vérification de data mais est refusée comme destination : ne l’utilisez pas. Tout le reste fonctionne comme pour 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"
}

App Link

qrType : "app". Guide du tableau de bord : QR code App Link.

Champ	Comportement
`link.ios`, `link.android`	URL App Store et Google Play. Les visiteurs iOS vont vers `ios`, les visiteurs Android vers `android`. Elles l’emportent sur tout le reste au moment du scan.
`link.url`	La destination de repli pour les autres appareils. Par défaut `data`, puis `ios` ou `android`.
`data`	Une URL http(s) (le tableau de bord envoie l’URL du store), ou vide. Au moins un champ parmi `link.ios`, `link.android`, `link.url` ou `data` doit être défini, sinon l’appel renvoie `400 Missing destination URL`.
`fileId`	Non autorisé.
Encode	Le lien court. Les scans sont suivis.
Après impression	Modifiable. `link.ios` et `link.android` sont appliqués indépendamment, chacun seulement s’il est envoyé. `null` en efface un. Inutile de renvoyer `qrType`. Passer à un autre type efface les deux liens de store.

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

Erreurs :

422 Invalid URL
400 Missing destination URL

Email

qrType : "email". Guide du tableau de bord : QR code Email.

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

Champ	Comportement
`data`	Une URI `mailto:` avec un objet et un corps facultatifs. Encodez les espaces en `%20` : le tableau de bord les écrit en `+`, que toutes les applications de messagerie ne lisent pas comme un espace. `matmsg:` est refusé comme destination.
`link.url`	L’URI `mailto:`. Par défaut `data`.
`fileId`	Non autorisé.
Encode	Le lien court, qui ouvre une page qui passe le relais à l’application de messagerie.
Après impression	Modifiable. Envoyez `data` ou `link.url` pour modifier le message. `data` seul suffit.

Request body

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

Erreurs :

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

SMS

qrType : "sms". Guide du tableau de bord : QR code SMS.

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

Champ	Comportement
`data`	Une URI `sms:` avec un corps facultatif. Le tableau de bord ne lit que cette forme exacte. `smsto:` est refusé comme destination.
`link.url`	L’URI `sms:`. Par défaut `data`.
`fileId`	Non autorisé.
Encode	Le lien court, qui ouvre une page qui passe le relais à l’application de messages.
Après impression	Modifiable. Envoyez `data` ou `link.url` pour modifier le message. `data` seul suffit.

Request body

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

Erreurs :

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

WiFi

qrType : "wifi". Guide du tableau de bord : QR code WiFi.

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

Champ	Comportement
`data`	Obligatoire. Respectez l’ordre `T`, `S`, `P`, `H` : l’éditeur et la liste du tableau de bord en dépendent. Échappez `\`, `;`, `"` et `:` dans le SSID et le mot de passe avec une barre oblique inverse. Pour un réseau ouvert, utilisez `T:nopass` avec un `P:` vide. Les scanners refusent `T:none`. Builder : SSID obligatoire, mot de passe d’au moins 8 caractères sauf avec `nopass`.
`link.url`	Non utilisé pour le scan. Par défaut `data`.
`fileId`	Non autorisé.
Encode	Le payload `WIFI:` brut, pas le lien court. Les scans ne sont pas suivis.
Après impression	Non modifiable. Un nouveau `data` ne change que les futurs téléchargements. Les codes imprimés gardent l’ancien réseau.

Request body

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

Erreurs :

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

Ne changez pas le type d’un QR code WiFi imprimé. Les codes imprimés gardent l’ancien réseau.

PDF, Image et Video

qrType : "pdf", "image" ou "video". Guides du tableau de bord : PDF, Image, Video.

Champ	Comportement
`fileId`	Le fichier. Importez-le avec la cible correspondant au type : `pdf`, `image` ou `video`. Avec un `fileId`, `link.url` devient l’URL du fichier, et tout ce que vous y envoyez est ignoré.
`data`	N’importe quoi sauf le payload d’un autre type (`WIFI:`, `BEGIN:VCARD`, `sms:`, `mailto:`, un objet JSON). Vide convient.
`link.url`	Sans `fileId`, `link.url` (ou `data`) sert de destination externe. Cela fonctionne, mais le tableau de bord n’affiche aucun fichier.
Encode	Le lien court, qui redirige directement vers le fichier. Un PDF s’ouvre comme fichier brut, pas dans une page de visualisation.
Après impression	Modifiable. Envoyez un nouveau `fileId` pour remplacer le fichier. L’ancien est libéré.

Un fichier par QR code : les lots de PDF et les galeries d’images ne sont pas disponibles via l’API. Consultez Non pris en charge par l’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"
}

Pour importer le fichier et obtenir son fileId, consultez Fichiers.

vCard

qrType : "vcard". Guide du tableau de bord : QR code vCard.

Champ	Comportement
`data`	Obligatoire. Texte vCard 3.0 commençant par `BEGIN:VCARD`, lignes séparées par `\r\n` (`\n` fonctionne aussi).
`fileId`	Image de profil facultative (cible `logo`), utilisée quand `data` n’a pas de ligne `PHOTO` ni `X-GETQR-IMAGE-FILEID`.
`link.url`	Ignoré et remplacé par la page hébergée. Omettez-le.
Encode	Le lien court, qui ouvre la page de contact hébergée avec un téléchargement pour enregistrer le contact (`.vcf`).
Après impression	Modifiable. Envoyez un nouveau `data` pour mettre à jour la page.

La page de destination et l’éditeur ne lisent que les formes de lignes ci-dessous. Les autres variantes, comme TEL;CELL: ou EMAIL;TYPE=INTERNET:, sont stockées mais n’apparaissent pas sur la page.

N:<last>;<first>;;; : nom et prénom. Builder : les deux obligatoires, jusqu’à 40 caractères.
FN:<first> <last> : non lu par la page. Le libellé dans la liste du tableau de bord en provient.
ORG:<company> et TITLE:<role> : entreprise et fonction. Builder : jusqu’à 40 caractères.
TEL;TYPE=HOME:, TEL;TYPE=CELL:, TEL;TYPE=WORK:, TEL;TYPE=FAX: : numéros de téléphone, de mobile, professionnel et de fax (+ et chiffres).
EMAIL:<email> : adresse e-mail.
URL:<url> : site web.
NOTE:<text> : résumé. Échappez \\, \n, \; et \,. Builder : jusqu’à 200 caractères.
ADR:;;<street>;<city>;<state>;<zip>;<country> : adresse.
X-SOCIALPROFILE;TYPE=<platform>:<url> ou URL;TYPE=<PLATFORM>:<url> : liens de réseaux sociaux, une ligne par plateforme.
PHOTO;VALUE=URI:<url> : URL de l’image de profil. L’emporte sur tout ID de fichier.
X-GETQR-IMAGE-FILEID:<fileId> : image de profil (cible logo).
X-GETQR-PAGE-LOGO-FILEID:<fileId> : logo de la page (cible logo).
X-GETQR-LANDING-THEME:p|<0-4> ou X-GETQR-LANDING-THEME:c|#RRGGBB|#RRGGBB|#RRGGBB : thème de la page de destination, soit l’index d’un thème prédéfini (0 à 4), soit des couleurs personnalisées d’arrière-plan, de bouton et d’icône.

Plateformes sociales : 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"
}

Erreurs :

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

qrType : "social". Guide du tableau de bord : QR code Social Media.

Champ	Comportement
`data`	Obligatoire. Une chaîne JSON qui encode un objet. Construisez-la avec `JSON.stringify`.
`fileId`	Image de profil facultative au premier niveau (cible `logo`).
`link.url`	Ignoré et remplacé par la page hébergée. Omettez-le.
Encode	Le lien court, qui ouvre la page sociale hébergée.
Après impression	Modifiable. Envoyez un nouveau `data` pour mettre à jour la page.

Champs de data :

Champ	Type	Remarques
`firstName`	string	Titre de la page et seul nom affiché. Builder : obligatoire, jusqu’à 40.
`lastName`	string	Jusqu’à 40. Non affiché sur la page.
`summary`	string	Jusqu’à 200.
`socialLinks`	`{ platform, url }[]`	`platform` est l’une des plateformes sociales de la vCard. Builder : chaque plateforme une seule fois.
`customItems`	`{ name, url, logoFileId }[]`	Builder : `name` jusqu’à 40, une `url` http(s) et un `logoFileId`. Au moins un lien social ou un élément personnalisé au total.
`fileId`	string	Image de profil (cible `logo`). Le `fileId` de premier niveau sert de repli.
`imageUrl`	string	URL externe de l’image de profil, utilisée seulement en l’absence d’ID de fichier.
`pageLogoFileId`	string	Logo de la page (cible `logo`).
`landingThemeMode`	`"preset" \| "custom"`	Par défaut `preset`.
`landingPresetIndex`	0–4	Par défaut 0.
`landingCustomBg`, `landingCustomButton`, `landingCustomIcon`	`#RRGGBB`	Utilisés quand le mode est `custom`.

Request body

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

Erreurs :

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

Multi-Link

qrType : "multilink". Guide du tableau de bord : QR code Multi-Link.

Champ	Comportement
`data`	Obligatoire. Une chaîne JSON qui encode un objet.
`fileId`	Image de profil facultative au premier niveau (cible `logo`).
`link.url`	Ignoré et remplacé par la page hébergée. Omettez-le.
Encode	Le lien court, qui ouvre la page multi-liens hébergée.
Après impression	Modifiable. Envoyez un nouveau `data` pour mettre à jour la page.

Les champs de data sont ceux de Social Media, sauf que firstName, lastName et summary sont remplacés par :

Champ	Type	Remarques
`title`	string	Titre de la page. Builder : obligatoire, jusqu’à 40.
`description`	string	Jusqu’à 200.

Dans customItems, logoFileId est facultatif : une icône par défaut s’affiche. Builder : au moins un lien social ou un élément personnalisé non vide.

Request body

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

Erreurs :

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

Event

qrType : "event". Guide du tableau de bord : QR code Event.

Champ	Comportement
`data`	Obligatoire. Une chaîne JSON qui encode un objet. Les valeurs inconnues ou invalides reprennent leur valeur par défaut.
`fileId`	Validé (cible `logo`) et stocké, mais la page de l’événement ne lit sa couverture que dans `data.fileId`. Placez l’ID de la couverture dans le payload.
`link.url`	Ignoré et remplacé par la page hébergée. Omettez-le.
Encode	Le lien court, qui ouvre la page de l’événement hébergée avec un téléchargement `.ics`.
Après impression	Modifiable. Envoyez un nouveau `data` pour mettre à jour la page.

Champs de data :

Champ	Type	Remarques
`name`	string	Builder : obligatoire.
`eventType`	string	L’un des types d’événement ci-dessous, ou vide.
`start`, `end`	`"YYYY-MM-DDTHH:mm"`	Heure locale dans `timezone`. Builder : les deux obligatoires, la fin après le début.
`timezone`	IANA, par exemple `"Europe/Berlin"`	Place le début et la fin dans le fichier `.ics`. Envoyez-le toujours : avec un fuseau vide ou inconnu, le `.ics` traite les heures comme de l’UTC.
`street`, `zip`, `city`, `state`, `country`	string	Builder : `city` et `country` obligatoires, jusqu’à 40 chacun.
`facilities`	string[]	ID de la liste ci-dessous. Les ID inconnus sont ignorés.
`notes`	string	Texte libre.
`fileId`	string	Image de couverture (cible `logo`).
`pageLogoFileId`	string	Logo de la page (cible `logo`).
`organizerName`, `organizerEmail`, `mobile`, `work`	string	`mobile` et `work` jusqu’à 40.
`socialLinks`	`{ platform, url }[]`	Les plateformes sociales de la vCard, plus `website`.
`ticketsUrl`	URL http(s)	Lien pour acheter des billets.
`ticketsLabel`	string	Jusqu’à 20 caractères. Les libellés plus longs sont tronqués. Vide affiche le libellé par défaut.

Types d'événement

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

Équipements

Groupe	ID
Entrée	`freeEntry`, `idRequired`, `invitationOnly`, `plusOneAllowed`, `reEntryAllowed`
Âge (un seul choix)	`adultsOnly`, `age18Plus`, `age21Plus`, `kidsWelcome`
Sur place	`parking`, `publicTransport`, `shuttle`, `wheelchairAccess`, `evCharging`, `wifi`, `foodDrinks`, `alcoholServed`, `atm`, `coatCheck`, `pool`, `phoneCharging`, `firstAid`, `wc`
Règles	`petsAllowed`, `noPets`, `smokingArea`, `noSmoking`, `noPhotos`
Code vestimentaire (un seul choix)	`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\"}"
}

Erreurs :

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

Fichiers dans les QR codes

Enregistrez un fichier avec Fichiers, importez-le, puis transmettez son fileId. Utilisez la cible qui correspond à l’usage :

pdf, image, video. Le contenu d’un QR code PDF, Image ou Video.
logo. Images de profil, logos de page, icônes de liens personnalisés et logos centraux.

Les fichiers qui ne sont jamais rattachés à un QR code sont supprimés après un délai de grâce. Erreurs liées à fileId, renvoyées à la création et sur PATCH quand fileId est envoyé :

Statut	Cause
`422 unprocessable_entity`	Le type n’accepte pas de fichier. Seuls `pdf`, `image`, `video`, `vcard`, `social`, `multilink` et `event` en acceptent un.
`404 not_found`	Aucun fichier avec cet ID. Enregistrez-le d’abord avec `POST /api/v1/files`.
`422 unprocessable_entity`	Le fichier a été importé pour une autre cible. Par exemple, un import `image` sur un QR code PDF, ou un import `pdf`, `image` ou `video` utilisé comme photo de vCard.
`422 unprocessable_entity`	Le fichier est enregistré, mais l’import vers `uploadUrl` ne s’est jamais terminé.

Les ID de fichiers à l’intérieur d’un payload (fileId, pageLogoFileId, customItems[].logoFileId, lignes X-GETQR-*-FILEID) ne sont pas validés. Ils ne s’affichent que s’ils ont été importés avec la cible logo. Le QR code se les approprie, le nettoyage ne les touche donc pas.

Changer de type

Vous pouvez changer qrType avec Modifier un QR code. Envoyez un data qui correspond au nouveau type : le payload stocké appartient à l’ancien type, donc un changement sans lui est refusé. Après une mise à jour, la destination est déterminée dans cet ordre :

vcard, social, multilink, event : toujours la page hébergée.
Un lot de PDF ou une galerie d’images créé dans le tableau de bord : sa page de destination.
pdf, image, video : l’URL du fichier (un nouveau fileId, sinon celui stocké).
link.url, s’il est envoyé.
Le data modifié.
L’URL stockée.

Effet de chaque changement :

Depuis pdf, image ou video. fileId et tout lot ou galerie sont effacés.
Vers pdf, image ou video. Envoyez aussi fileId, sinon celui stocké est réutilisé, et il peut s’agir d’une photo de vCard.
Depuis app. Le nom de l’application, link.ios et link.android sont effacés, pour que les téléphones suivent la nouvelle destination.
Vers wifi. L’image passe au payload brut. Les codes déjà imprimés contiennent toujours le lien court, qui redirige désormais vers une URL wifi:.
Depuis wifi. Les codes imprimés gardent leur ancien réseau.
Vers vcard, social, multilink ou event. Le lien court pointe vers la nouvelle page hébergée.
Depuis vcard, social, multilink ou event. Envoyez le nouveau data. La destination le suit.

Les QR codes statiques créés dans le tableau de bord n’ont pas de lien court : modifier leur link.url renvoie donc 422.

Non pris en charge par l’API

Ces fonctionnalités du tableau de bord ne font pas partie de l’API v1. Les champs inconnus sont ignorés sans erreur, les envoyer n’a donc aucun effet.

Champ	Description
`appName`	Le nom affiché d’un QR code App Link. Les QR codes App Link créés via l’API affichent leur URL de store dans la liste du tableau de bord.
`isStatic`	Un QR code statique sans lien court. Chaque QR code créé par l’API en a un, il peut donc être modifié et suivi après impression (sauf `wifi`).
`pdfBundle`	Un QR code PDF avec deux fichiers ou plus. L’API ne crée que des QR codes PDF à fichier unique.
`imageGallery`	Un QR code Image avec deux images ou plus. L’API ne crée que des QR codes à image unique.

Les lots et galeries créés dans le tableau de bord peuvent toujours être lus, mis en pause et supprimés via l’API, mais leurs fichiers ne peuvent pas être modifiés par ce biais.

Problèmes courants

422 Invalid destination URL

link.url utilise un schéma vers lequel le lien court ne peut pas rediriger, comme geo:, smsto:, matmsg: ou tel:. Utilisez les formats de cette page.

400 Missing destination URL

data est vide et il n’y a pas de link.url. Pour app, définissez au moins un champ parmi link.ios, link.android, link.url ou data.

La valeur data de la réponse est un lien court, pas mon URL

Pour les types de lien, le data stocké est le lien court. Lisez la destination dans url.

La page de destination n'affiche pas certains détails de mon payload

La page ne lit que les champs et formes de lignes listés pour le type. Les autres champs sont stockés mais pas affichés.

API

Données des QR codes par type

Aperçu de tous les types

Comment un QR code est résolu

Website

Feedback

Payment

WhatsApp

Location

App Link

Email

SMS

WiFi

PDF, Image et Video

vCard

Multi-Link

Event

Fichiers dans les QR codes

Changer de type

Non pris en charge par l’API

Problèmes courants

Et ensuite

QR codes

Fichiers

Personnalisation

Règles d'accès

​Aperçu de tous les types

​Comment un QR code est résolu

​Website

​Feedback

​Payment

​WhatsApp

​Location

​App Link

​Email

​SMS

​WiFi

​PDF, Image et Video

​vCard

​Social Media

​Multi-Link

​Event

​Fichiers dans les QR codes

​Changer de type

​Non pris en charge par l’API

​Problèmes courants

​Et ensuite

QR codes

Fichiers

Personnalisation

Règles d'accès

Aperçu de tous les types

Comment un QR code est résolu

Website

Feedback

Payment

WhatsApp

Location

App Link

Email

SMS

WiFi

PDF, Image et Video

vCard

Social Media

Multi-Link

Event

Fichiers dans les QR codes

Changer de type

Non pris en charge par l’API

Problèmes courants

Et ensuite