La ressource ScanLog expose chaque événement de scan enregistré pour un QR code. Utilisez-la pour alimenter des tableaux de bord analytiques, diagnostiquer des campagnes de diffusion ou auditer les scans récents d’un code.
Représentation de la ressource
Les réponses de collection incluent une entrée par scan, classées du plus récent au plus ancien. Chaque log capture l’horodatage du scan, l’identifiant du QR code et le pays déduit de l’adresse IP du visiteur.
{
"id": "68d026db486dd2e1ae0ad518",
"datetime": "2025-09-21T16:24:59+00:00",
"qrCode": "/qr_codes/68cdbbe0ed096c7b590277c6",
"country": "FR"
}
Référence des champs
| Champ | Type | Description |
|---|---|---|
id |
string |
Identifiant unique de l’entrée de scan. |
datetime |
datetime |
Horodatage ISO 8601 indiquant quand le scan a eu lieu. |
qrCode |
string |
IRI du QR code associé au scan. |
country |
`string | null` |
Remarque : L’adresse IP, le fuseau horaire et l’agent utilisateur sont collectés en interne mais ne sont pas exposés via l’API publique.
Lister les ScanLogs — GET /qr_codes/{id}/scans
Récupérez l’historique des scans pour un QR code appartenant à votre équipe. Les résultats sont triés par datetime décroissant afin que le scan le plus récent apparaisse en premier.
curl -X GET "https://api.twilee.com/qr_codes/68cdbbe0ed096c7b590277c6/scans" \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Accept: application/json"
Réponse (JSON-LD)
{
"@context": "/contexts/ScanLog",
"@id": "/qr_codes/68cdbbe0ed096c7b590277c6/scans",
"@type": "Collection",
"totalItems": 7,
"member": [
{
"@id": "/scan_logs/68d026db486dd2e1ae0ad518",
"@type": "ScanLog",
"datetime": "2025-09-21T16:24:59+00:00",
"qrCode": "/qr_codes/68cdbbe0ed096c7b590277c6",
"country": "FR"
}
]
}
Utilisez le paramètre page pour paginer la collection :
GET /qr_codes/{id}/scans?page=2
La pagination suit le comportement par défaut d’API Platform.