GET
/api/v1/dispositivosListar Dispositivos
Lista dispositivos autorizados da matriz e filiais. Paginação com page/limit. Requer scope dispositivos:read.
Autenticação:
🔑 API Key
Parâmetros de Consulta
statusstringFiltrar por status: pending, authorized, blocked, revoked
pagenumberPágina (padrão: 1)
limitnumberItens por página (padrão: 100, máximo: 500)
Respostas
{
"ok": true,
"data": {
"dispositivos": [
{
"id": 1,
"device_fingerprint": "abc123def456",
"device_token": "token_xyz",
"nome_dispositivo": "iPhone 14",
"status": "authorized",
"empresa_id": 1,
"last_access_at": "2026-01-15T10:00:00Z",
"is_sandbox": false,
"created_at": "2026-01-15T10:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 100,
"total": 25,
"totalPages": 1
}
}
}curl --request GET \
'https://rep-gestor.youuponto.com/api/v1/dispositivos?status=authorized&page=1&limit=100' \
--header 'x-api-key: yk_sua_api_key'Exemplos de Resposta
{
"ok": true,
"data": {
"dispositivos": [
{
"id": 1,
"device_fingerprint": "abc123def456",
"device_token": "token_xyz",
"nome_dispositivo": "iPhone 14",
"status": "authorized",
"empresa_id": 1,
"last_access_at": "2026-01-15T10:00:00Z",
"is_sandbox": false,
"created_at": "2026-01-15T10:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 100,
"total": 25,
"totalPages": 1
}
}
}