Editar

PUT

/device/{deviceId}

Atualiza um equipamento.

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

Regras

deviceModelId e deviceImei são obrigatórios também na edição.

Modelos e firmwares: https://app.apidog.com/project/922569/apis/doc-1335233

Nos modelos com firmware, envie firmwareId sempre. null não limpa simCardId, firmwareId nem customChannelNames.

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 Caminho

Parâmetros Bodyapplication/jsonObrigatório

Examples

Respostas

🟢200Sucesso

application/json

Bodyapplication/json

🟠400Bad request

🟠403Forbidden

🟠404Registry not found

🟠422Unprocessable Entity

🟠429Too Many Request

🔴500Internal server error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.cloud-services.yuv.com.br/device/321' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "deviceModelId": 16,
    "deviceImei": "864993060000000",
    "simCardId": null,
    "firmwareId": 42,
    "customChannelNames": {
        "1": "Frontal",
        "2": "Cabine"
    }
}'

Response Example

200 - Sucesso

{
    "data": {
        "deviceId": 12345,
        "deviceModelId": 16,
        "deviceImei": "12345678912",
        "deviceLastHeartbeat": "2025-10-08 14:35:12",
        "deviceLastGps": "2025-10-08 14:34:00",
        "deviceFirmwareId": 42,
        "deviceIsEnabled": true,
        "deviceNetworkType": "4G",
        "deviceManufacturerName": "Jimi Brasil",
        "deviceModelName": "JC450",
        "deviceOnline": true,
        "deviceChannels": {
            "1": "1",
            "2": "2",
            "3": "3",
            "4": "4",
            "5": "5"
        },
        "deviceCreatedAt": "2025-09-12T10:20:00Z",
        "deviceUpdatedAt": "2025-10-08T14:35:00Z",
        "assetId": 9876,
        "assetPrefix": "INF",
        "assetIdentifier": "INF-400-2",
        "customerId": 321,
        "customerName": "Jurandir Brasil",
        "simCardId": 5555,
        "simNumber": "+5511999999999"
    }
}

Modificado em 2026-10-15 18:08:10

Editar

Regras#

Requisição

Respostas

Regras