Le QR code de vos factures, en un appel.

Créer un code

Un POST avec le contenu dans le corps. Le contenu ne passe jamais dans l’adresse, pour ne pas rester dans les journaux des serveurs en chemin.

curl https://api.qrsensei.com/v1/qr \
  -H "Authorization: Bearer $QRSENSEI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": {
    "type": "text",
    "text": "FT 2026/118 · 149,90 EUR"
  },
  "brand": "qrsensei",
  "style": {
    "color": {
      "kind": "solid",
      "color": "#18181B"
    }
  },
  "format": "png",
  "size": 256
}'

Corps de la requête

Réponse

{
  "image": "data:image/png;base64,iVBORw0KGgo…",
  "format": "png",
  "remaining": 902,
  "limit": 1000,
  "resetsAt": "2026-12-01T00:00:00.000Z"
}

Les mêmes nombres arrivent dans les en-têtes X-QrSensei-Remaining, X-QrSensei-Limit et X-QrSensei-Reset.

Authentification

Chaque appel porte la clé de votre application dans l’en-tête Authorization: Bearer qs_live_….

• La clé n’est montrée qu’une fois, à sa création. Nous n’en gardons qu’une empreinte : si vous la perdez, créez-en une nouvelle dans votre profil et l’ancienne cesse de fonctionner.
• Appelez depuis votre serveur, jamais depuis un navigateur ou une app : une clé dans le code front-end peut être lue par n’importe qui.
• Rien des codes n’est conservé : ni le contenu, ni les images. Seulement un compte par mois.

Contenus

Les mêmes types que l’éditeur, avec les mêmes règles. Ce tableau est lu dans les règles qui vérifient chaque appel : il ne peut pas être périmé.

Un Wi-Fi sans mot de passe prend encryption "nopass". Un champ omis reste vide ; un champ obligatoire manquant est nommé dans le detail de l’erreur.

Styles

Dessinés dans votre profil, avec le code en direct à côté. Chacun a un id et l’un est votre style par défaut ; ou écrivez le style dans l’appel lui-même, comme style.

{}

{ "color": { "kind": "solid", "color": "#18181B" }, "background": { "kind": "transparent" }, "quietZone": 2 }

{ "dots": "dots", "finders": "drop", "color": { "kind": "gradient", "type": "linear", "angle": 45, "stops": [ "#0F172A", "#1E40AF" ] }, "background": { "kind": "solid", "color": "#FFF7ED" } }

Un style n’est accepté que s’il se lit : des formes qui vont ensemble, et une encre plus foncée que son papier avec un contraste d’au moins 4,5:1. Un code transparent est vérifié sur blanc, le papier d’une facture.

Marques

"auto" reconnaît la marque d’après le lien (un lien Instagram prend le logo d’Instagram). Un nom fixe la marque ; "none" laisse le centre libre. La liste vient aussi de GET /v1/brands.

Contre le phishing : sur un lien, une marque fixée n’est utilisée que si le lien est bien le sien. Le logo d’une banque n’atterrit jamais sur un faux lien.

• qrsensei
• instagram
• facebook
• linkedin
• x
• tiktok
• youtube
• github
• spotify
• whatsapp
• telegram
• signal
• viber
• snapchat
• pinterest
• threads
• discord
• reddit
• messenger
• googleMaps
• appleMaps
• waze
• paypal
• revolut
• wise
• stripe

Limites

Erreurs

Toujours un objet error avec code, message et, quand il aide, detail : le code est pour votre programme, le message pour qui le lit. Un appel en erreur n’est pas compté.