QR Points
QR Points
Section titled “QR Points”Puntos de código QR para registro de entrada/salida por ubicación.
POST /api/companies/{companyId}/locations/{locationId}/qr-points/v1
Section titled “POST /api/companies/{companyId}/locations/{locationId}/qr-points/v1”Crear punto QR
Parámetros
Section titled “Parámetros”| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
companyId | string | ✅ | |
locationId | string | ✅ |
Request Body (requerido ✅)
Section titled “Request Body (requerido ✅)”{ "label": "Entrada principal", "type": "FIXED" }Respuestas
Section titled “Respuestas”QR point creado exitosamente
{ "id": "00000000-0000-0000-0000-000000000000", "locationId": "00000000-0000-0000-0000-000000000000", "label": "label", "token": "00000000-0000-0000-0000-000000000000", "type": "FIXED", "active": true, "qrContent": "qrContent", "createdAt": "2024-01-15T10:00:00Z", "updatedAt": "2024-01-15T10:00:00Z" }GET /api/companies/{companyId}/locations/{locationId}/qr-points/v1
Section titled “GET /api/companies/{companyId}/locations/{locationId}/qr-points/v1”Listar QR points de una ubicación
Parámetros
Section titled “Parámetros”| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
companyId | string | ✅ | |
locationId | string | ✅ |
Respuestas
Section titled “Respuestas”Lista de QR points
{ "id": "00000000-0000-0000-0000-000000000000", "locationId": "00000000-0000-0000-0000-000000000000", "label": "label", "token": "00000000-0000-0000-0000-000000000000", "type": "FIXED", "active": true, "qrContent": "qrContent", "createdAt": "2024-01-15T10:00:00Z", "updatedAt": "2024-01-15T10:00:00Z" }DELETE /api/companies/{companyId}/locations/{locationId}/qr-points/v1/{qrPointId}
Section titled “DELETE /api/companies/{companyId}/locations/{locationId}/qr-points/v1/{qrPointId}”Desactivar QR point
Parámetros
Section titled “Parámetros”| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
companyId | string | ✅ | |
locationId | string | ✅ | |
qrPointId | string | ✅ |
Respuestas
Section titled “Respuestas”QR point desactivado exitosamente
Schemas
Section titled “Schemas”CreateQRPointRequest
Section titled “CreateQRPointRequest”| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
label | string ej: “Entrada principal” | ✅ | |
type | QRPointType | ✅ |
QRPointResponse
Section titled “QRPointResponse”| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string (uuid) | ❌ | |
locationId | string (uuid) | ❌ | |
label | string | ❌ | |
token | string (uuid) | ❌ | Token único para el QR |
type | QRPointType | ❌ | |
active | boolean | ❌ | |
qrContent | string | ❌ | Contenido para generar el QR (qentro://checkin/{token}?…) |
createdAt | string (date-time) | ❌ | |
updatedAt | string (date-time) | ❌ |