Assistants de contenu
Les QR codes pour les identifiants WiFi, les cartes de contact (vCard) et la géolocalisation utilisent des formats de texte précis. Ces endpoints assemblent la chaîne pour vous, que vous pouvez ensuite passer directement à /api/qr/generate comme content.
Les trois endpoints acceptent du JSON et renvoient du JSON. Aucun rendu n'a lieu : ce sont de simples constructeurs de chaînes.
WiFi
POST /api/qr/content/wifi
{
"ssid": "MyNetwork",
"password": "supersecret",
"encryption": "WPA",
"hidden": false
}
Réponse :
{
"success": true,
"content": "WIFI:T:WPA;S:MyNetwork;P:supersecret;H:false;;"
}
encryption : WPA, WEP ou nopass.
vCard
POST /api/qr/content/vcard
{
"firstName": "Ada",
"lastName": "Lovelace",
"organization": "Analytical Engine Co.",
"title": "Programmer",
"phone": "+44 20 7946 0958",
"email": "ada@example.com",
"url": "https://adalovelace.example",
"address": "10 Downing St, London"
}
Réponse : une chaîne vCard 3.0 complète, prête à encoder.
Geo
POST /api/qr/content/geo
{
"latitude": 40.4168,
"longitude": -3.7038,
"query": "Plaza Mayor, Madrid"
}
Réponse :
{
"success": true,
"content": "geo:40.4168,-3.7038?q=Plaza%20Mayor%2C%20Madrid"
}
query est facultatif : il ajoute un libellé lisible par Google Maps / Apple Maps.
Pourquoi ils existent
Vous pourriez construire ces chaînes vous-même, mais les formats ont des cas limites (échappement dans les mots de passe WiFi, repli des lignes dans les vCard, encodage URI dans Geo). Les assistants les gèrent pour qu'une faute de frappe ne laisse pas un client avec un QR qui affiche « MyNetwork P:supersecret » comme SSID.
Schéma d'utilisation
1. POST to /api/qr/content/{wifi|vcard|geo} → get the content string
2. POST that string as `content` to /api/qr/generate → get the QR
Vous pouvez aussi passer la chaîne assemblée directement à l'endpoint IA comme content si vous voulez que l'IA stylise le QR WiFi/vCard/Geo.