Create a dynamic session URL for a device
Generates a short URL and QR code for physical devices (kiosks, vending machines, etc.). When scanned, the URL creates a verification session and cancels any incomplete sessions for this device.
Authorization
bearerAuth AuthorizationBearer <token>
API token obtained from your Bouncer dashboard
In: header
Path Parameters
deviceCode*string
The unique device code assigned to your physical device
Request Body
application/json
qr_size?integer
Size of the QR code image in pixels
Default
300Range
100 <= value <= 1000ttl?integer
Time-to-live for the URL in seconds before a new one must be generated
Default
120Range
60 <= value <= 3600Response Body
application/json
application/json
application/json
curl -X POST "https://bouncer.test/api/v2/device/KIOSK-001/session-url" \ -H "Content-Type: application/json" \ -d '{ "qr_size": 300, "ttl": 120 }'{
"url": "https://bouncer.test/d/ABC123",
"qr_code": "data:image/png;base64,iVBORw0KGgo...",
"expires_at": "2024-01-15T10:32:00Z"
}{
"message": "Unauthenticated."
}{
"message": "The age_target field is required.",
"errors": {
"age_target": [
"The age_target field is required."
],
"redirect_url": [
"The redirect_url must be a valid URL."
]
}
}