Obter lista para seleção

GET

/device/get-available

Lista, de forma paginada e resumida (id + name), os equipamentos disponíveis para seleção, ideal para preencher campos de seleção (selects/autocomplete).

Disponível para: Revendedor e Cliente
Rate limit: 100 requisições/minuto

📌 Esta é a versão da documentação para token de Revendedor.

Revendedor x Cliente

Revendedor: retorna os equipamentos de todo o revendedor.

Cliente: retorna apenas os equipamentos dos ativos do próprio cliente, com deviceLastHeartbeat e deviceLastGps.

Regras

Os filtros vão na query string (diferente das outras listagens).

name vem no formato IMEI - identificador do ativo.

perPage vai de 1 a 100 (padrão 20).

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Consulta

Respostas

🟢200Sucesso

application/json

Bodyapplication/json

🟠400Bad request

🟠403Forbidden

🔴500Internal server error

🟠429Too Many Request

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.cloud-services.yuv.com.br/device/get-available?search=8649&page=1&perPage=20' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "currentPage": 1,
    "data": [
        {
            "id": 3051,
            "name": "864993060000000 - ABC1D23"
        },
        {
            "id": 3052,
            "name": "864993060000001 - DEF4G56"
        }
    ],
    "lastPage": 1,
    "perPage": 20,
    "total": 2
}

Modificado em 2026-10-15 17:55:30

Obter lista para seleção

Revendedor x Cliente#

Regras#

Requisição

Respostas

Revendedor x Cliente

Regras