Oquira BusinessUse QR codes and NFC tags to simplify access to your services.
Oquira supports QR codes and NFC tags to allow customers to join a queue or check in quickly by simply scanning a code.
| Type | Usage |
|---|---|
service_checkin | Check-in to a service |
queue_join | Join a queue |
operator_access | Operator access |
verification | Presence verification |
single_use_invite | Single-use invitation |
POST /v1/qr-tokens
X-API-Key: your_api_key_here
Content-Type: application/json
{
"purpose": "queue_join",
"queueId": "que_abc...",
"expiresAt": "2024-03-16T18:00:00Z"
}| Property | Type | Required | Description |
|---|---|---|---|
purpose | string | Yes | Token type |
serviceId | string | No | Associated service |
queueId | string | No | Associated queue |
expiresAt | string | No | Expiration date |
POST /v1/qr/scan
X-API-Key: your_api_key_here
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: your_api_key_here| Parameter | Description |
|---|---|
token | QR token to encode |
size | Size in pixels (default: 200) |
format | png or svg |
| Type | Description |
|---|---|
physical | Physical NFC tag installed on-site |
virtual | Virtual tag (for testing) |
mobile_wallet | Apple/Google Wallet integration |
POST /v1/nfc/tags
X-API-Key: your_api_key_here
Content-Type: application/json
{
"nfcId": "04A3B2C1D0E9F8",
"queueId": "que_abc...",
"locationName": "Main entrance",
"latitude": 6.3702,
"longitude": 2.3912
}POST /v1/nfc/scan
X-API-Key: your_api_key_here
Content-Type: application/json
{
"nfcId": "04A3B2C1D0E9F8",
"latitude": 6.3701,
"longitude": 2.3910,
"deviceInfo": {
"phoneModel": "iPhone 14",
"osVersion": "iOS 17"
}
}Retrieve the current status and scan statistics for a specific NFC tag using its physical identifier.
GET /v1/nfc/tags/{nfcId}
X-API-Key: your_api_key_herePlace a QR code or NFC tag at the entrance to allow visitors to take a ticket instantly.
Use an ephemeral QR code to confirm that a customer is actually on-site.
Generate a dynamic QR code on the waiting room screen allowing new arrivals to join the queue.
Tip: NFC tags are perfect for high-traffic areas as they allow faster scanning than QR codes.