Cadastrar

POST

/asset

Cadastra um ativo (veículo) e, opcionalmente, já o vincula a um cliente e a um equipamento.

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

Regras

Apenas identifier é obrigatório.

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

🔴500Internal server error

🟠429Too Many Request

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.cloud-services.yuv.com.br/asset' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "identifier": "ABC1D23",
    "prefix": "CAM-01",
    "customerId": 45,
    "deviceId": 321,
    "manufacturer": "Volvo",
    "model": "FH 540",
    "year": "2022",
    "color": "Branco",
    "size": "Pesado"
}'

Response Example

200 - Sucesso

{
    "data": {
        "assetId": 8546,
        "assetIdentifier": "INF-400-2",
        "assetPrefix": "INF",
        "assetManufacturer": "Volkswagen",
        "assetModel": "Delivery 9.170",
        "assetYear": "2021",
        "assetColor": "Branco",
        "assetLastHeartbeat": "2025-10-08 14:40:12",
        "assetLastGps": "2025-10-08 14:25:33",
        "assetSize": "small",
        "assetCreatedAt": "2024-03-12T09:15:00Z",
        "assetUpdatedAt": "2025-10-08T14:42:00Z",
        "customerId": 321,
        "customerName": "Jurandir Brasil",
        "deviceId": 11318,
        "deviceImei": "12345678912",
        "deviceOnline": true
    }
}

Modificado em 2026-10-02 19:54:17

Cadastrar

Regras#

Requisição

Respostas

Regras