Oquira BusinessUtilisez les codes QR et les tags NFC pour simplifier l'accès à vos services.
Oquira supporte les codes QR et les tags NFC pour permettre aux clients de rejoindre une file d'attente ou de s'enregistrer rapidement en scannant simplement un code.
| Type | Usage |
|---|---|
service_checkin | Check-in à un service |
queue_join | Rejoindre une file d'attente |
operator_access | Accès opérateur |
verification | Vérification de présence |
single_use_invite | Invitation usage unique |
POST /v1/qr-tokens
X-API-Key: votre_cle_api
Content-Type: application/json
{
"purpose": "queue_join",
"queueId": "que_abc...",
"expiresAt": "2024-03-16T18:00:00Z"
}| Propriété | Type | Requis | Description |
|---|---|---|---|
purpose | string | Oui | Type de token |
serviceId | string | Non | Service associé |
queueId | string | Non | File associée |
expiresAt | string | Non | Date d'expiration |
POST /v1/qr/scan
X-API-Key: votre_cle_api
Content-Type: application/json
{
"token": "oquira_qr_abc123def456",
"latitude": 6.3702,
"longitude": 2.3912
}GET /v1/qr/generate?token={token}&size=300&format=png
X-API-Key: votre_cle_api| Paramètre | Description |
|---|---|
token | Token QR à encoder |
size | Taille en pixels (défaut: 200) |
format | png ou svg |
| Type | Description |
|---|---|
physical | Tag NFC physique installé sur place |
virtual | Tag virtuel (pour tests) |
mobile_wallet | Intégration Apple/Google Wallet |
POST /v1/nfc/tags
X-API-Key: votre_cle_api
Content-Type: application/json
{
"nfcId": "04A3B2C1D0E9F8",
"queueId": "que_abc...",
"locationName": "Entrée principale",
"latitude": 6.3702,
"longitude": 2.3912
}POST /v1/nfc/scan
X-API-Key: votre_cle_api
Content-Type: application/json
{
"nfcId": "04A3B2C1D0E9F8",
"latitude": 6.3701,
"longitude": 2.3910,
"deviceInfo": {
"phoneModel": "iPhone 14",
"osVersion": "iOS 17"
}
}Récupérez le statut actuel et les statistiques de scan pour un tag NFC spécifique en utilisant son identifiant physique.
GET /v1/nfc/tags/{nfcId}
X-API-Key: votre_cle_apiPlacez un QR code ou tag NFC à l'entrée pour permettre aux visiteurs de prendre un ticket instantanément.
Utilisez un QR code éphémère pour confirmer qu'un client est bien sur place.
Générez un QR code dynamique sur l'écran de la salle d'attente permettant aux nouveaux arrivants de rejoindre la file.
Astuce : Les tags NFC sont parfaits pour les zones à fort trafic car ils permettent un scan plus rapide que les QR codes.