Helper di contenuto
I codici QR per credenziali WiFi, biglietti da visita (vCard) e geolocalizzazione usano formati di testo specifici. Questi endpoint assemblano la stringa di contenuto per te, così puoi passarla direttamente a /api/qr/generate come content.
Tutti e tre gli endpoint accettano JSON e restituiscono JSON. Non generano nessuna immagine: costruiscono solo stringhe.
WiFi
POST /api/qr/content/wifi
{
"ssid": "MyNetwork",
"password": "supersecret",
"encryption": "WPA",
"hidden": false
}
Risposta:
{
"success": true,
"content": "WIFI:T:WPA;S:MyNetwork;P:supersecret;H:false;;"
}
encryption: WPA, WEP o 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"
}
Risposta: una stringa vCard 3.0 completa, pronta da codificare.
Geo
POST /api/qr/content/geo
{
"latitude": 40.4168,
"longitude": -3.7038,
"query": "Plaza Mayor, Madrid"
}
Risposta:
{
"success": true,
"content": "geo:40.4168,-3.7038?q=Plaza%20Mayor%2C%20Madrid"
}
query è facoltativo: aggiunge un'etichetta leggibile da Google Maps / Apple Maps.
Perché esistono
Potresti costruire le stringhe da solo, ma i formati hanno casi limite (escaping nelle password WiFi, ripiegamento delle righe nella vCard, codifica URI in Geo). Gli helper li gestiscono, così un errore di battitura non lascia un cliente con un QR che mostra "MyNetwork P:supersecret" come SSID.
Schema d'uso
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
Puoi anche passare la stringa assemblata direttamente all'endpoint IA come content se vuoi che sia l'IA a dare stile al QR WiFi/vCard/Geo.