Enviar comando
POST
/device/send-command
Rate limit: 80 requisições/minuto (operação pesada)
Regras
commandString é enviado exatamente como informado (ex.: STATUS).Erros específicos
401 com {"error": "Customer is not allowed to send commands"}.{"error": {"source": "device", "code": <código>, "message": "<mensagem>"}}. A message vem no idioma do usuário do token.| Status | code | Significado |
|---|---|---|
| 400 | 200 | Parâmetro inválido no comando enviado ao dispositivo |
| 503 | 300 | Dispositivo offline |
| 404 | 301 | Dispositivo não registrado no gateway (IMEI sem rota) |
| 409 | 302 | Dispositivo ocupado: o último comando ainda não obteve resposta |
| 502 | 304 | Falha ao enviar o comando via SMS |
| 502 | 400 | Erro de rede ao comunicar com o IoT Hub |
| 502 | 500 | Erro interno ao executar o comando no IoT Hub |
| 504 | 600 | Tempo limite excedido ao aguardar resposta do dispositivo |
| 504 | 602 | O equipamento não respondeu ao comando |
303 (comando enviado por SMS) é sucesso: responde 200 com commandResponse.500 com {"error": "Erro no dispositivo: Dispositivo não encontrado"}; equipamento sem ativo vinculado → 500 com {"error": "Erro no ativo: Ativo não encontrado"}.Requisição
Parâmetros Bodyapplication/jsonObrigatório
Respostas
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 Response Example
200 - Sucesso
{
"commandResponse": "GPS:OK; GSM:4; BAT:100%"
}Modificado em 2026-10-15 17:57:28