Listar 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

statusstring

Filtrar por status: pending, authorized, blocked, revoked

pagenumber

Página (padrão: 1)

limitnumber

Itens por página (padrão: 100, máximo: 500)

Respostas

{
  "ok": true,
  "data": {
    "dispositivos": [
      {
        "id": 1,
        "nome_dispositivo": "iPhone 14",
        "status": "authorized",
        "empresa_id": 1,
        "colaborador_id": 10,
        "created_at": "2026-01-15T10:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 100,
      "total": 25,
      "totalPages": 1
    }
  }
}

Sandbox Mode

curl --request GET \
  'http://localhost:3000/api/v1/dispositivos?status=Autorizado&page=1&limit=100' \
  --header 'x-api-key: yk_sua_api_key'

Exemplos de Resposta

{
  "ok": true,
  "data": {
    "dispositivos": [
      {
        "id": 1,
        "nome_dispositivo": "iPhone 14",
        "status": "authorized",
        "empresa_id": 1,
        "colaborador_id": 10,
        "created_at": "2026-01-15T10:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 100,
      "total": 25,
      "totalPages": 1
    }
  }
}