Cadastrar

POST

/device

Cadastra um equipamento.

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

Regras

deviceModelId e deviceImei são obrigatórios.

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

deviceImei tem no mínimo 4 caracteres e é único. customChannelNames aceita até 10 caracteres por canal. firmwareId é obrigatório se o modelo tem firmware, e não deve ser enviado se não tem.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

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

Parâmetros Bodyapplication/jsonObrigatório

Examples

Respostas

🟢200Sucesso

application/json

Bodyapplication/json

🟠400Bad request

🟠403Forbidden

🟠422Unprocessable Entity

🟠429Too Many Request

🔴500Internal server error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.cloud-services.yuv.com.br/device' \
--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": 321,
        "deviceModelId": 13,
        "deviceImei": "864993060000000",
        "deviceLastHeartbeat": null,
        "deviceLastGps": null,
        "deviceFirmwareId": 42,
        "deviceIsEnabled": true,
        "deviceNetworkType": null,
        "deviceManufacturerName": "Jimi Brasil",
        "deviceModelName": "JC450",
        "deviceOnline": false,
        "deviceChannels": {
            "1": "Frontal",
            "2": "Cabine"
        },
        "deviceCreatedAt": "2025-05-20T12:00:00Z",
        "deviceUpdatedAt": "2025-05-20T12:00:00Z",
        "assetId": null,
        "assetPrefix": null,
        "assetIdentifier": null,
        "customerId": null,
        "customerName": null,
        "simCardId": null,
        "simNumber": null
    }
}

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

Cadastrar

Regras#

Requisição

Respostas

Regras