Enviar comando

POST

/device/send-command

Envia um comando de forma síncrona para um equipamento Jimi IoT e devolve a resposta do equipamento.

Disponível para: Somente Revendedor
Rate limit: 80 requisições/minuto (operação pesada)

Regras

O equipamento precisa estar online para responder.

commandString é enviado exatamente como informado (ex.: STATUS).

Erros específicos

Token de Cliente → 401 com {"error": "Customer is not allowed to send commands"}.

Falha ao enviar o comando ao equipamento → 400 com {"error": "<mensagem do equipamento>"}.

Quando o IMEI não pertence ao seu escopo (ou o equipamento não tem ativo vinculado), a API responde 500 com {"error": "Dispositivo <IMEI> não encontrado"} / "Ativo do dispositivo <IMEI> não encontrado".

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

🟠401Unauthorized (token de Cliente)

🟠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/send-command' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "deviceImei": "864993060000000",
    "commandString": "STATUS"
}'

Response Example

200 - Sucesso

{
    "commandResponse": "GPS:OK; GSM:4; BAT:100%"
}

Modificado em 2026-10-05 17:47:33

Enviar comando

Regras#

Erros específicos#

Requisição

Respostas

Regras

Erros específicos