IotHub M2M
  1. Docs M2M
IotHub M2M
  • API
    • M2M
      • Solicitações
        • Criar Solicitação
        • Cancelar Solicitação
      • Dispositivos
        • Atualizar Atributos de Dispositivos
        • Atualizar Atributos de um Dispositivo
  • Docs M2M
    • 1.Integração M2M
    • 2.O que mudou
    • 3.Autenticação da API
    • 4.Operações de Entrada
    • 5.Operações de Saída
    • 6. Guia de configuração IoT Hub com M2M
  1. Docs M2M

4.Operações de Entrada

Criar Solicitação#

Nesta operação, o método cria uma solicitação no sistema da Exati. Após a requisição, a Exati retorna uma resposta indicando conformidade da operação. Para detalhes mais específicos da operação, verifique Criar Solicitação
MétodoPOST
Endpoint/clients/:idInstance/tickets
Content-Typeapplication/json

Exemplo Corpo da Requisição#

{
  "cod_external_ticket_origin": "tg",
  "ticket_origin_type_id": 1,
  "id_external_protocol": 1,
  "external_protocol": "string",
  "service_code": "string",
  "justification": "string",
  "description": "string",
  "id_worksite": 1,
  "state_abbreviation": "AC",
  "municipality": "string",
  "neighborhood": "string",
  "address": "string",
  "address_number": 0,
  "zip_code": "65903-350",
  "latitude": "45.123",
  "longitude": "76.486",
  "reference_point": "string",
  "reporter": "string",
  "reporter_phone": "84968718020",
  "reporter_birth_date": "01/01/1900",
  "nameplate_num": "string",
  "age_majority_checkbox": 1
}

Exemplo Corpo da Resposta#

201 - Created
{
    "id_demanda": 12348,
    "operacao": "cria",
    "data_recebido": 1711217789710,
    "status": "ok",
}

Dica#

Para mais detalhes sobre o uso deste endpoint, assista ao vídeo mostrando a operação sendo feita pelo Postman aqui.

Cancelar Solicitação#

Nesta operação, o método cancela a solicitação no sistema da Exati. Após a requisição, a Exati retorna uma resposta indicando conformidade da operação. Para detalhes mais específicos da operação, verifique
Cancelar Solicitação
MétodoDELETE
Endpoint/clients/:idInstance/tickets
Content-Typeapplication/json

Exemplo Corpo da Requisição#

{
  "cod_external_ticket_origin": "tg",
  "id_external_protocol": 1,
  "justification": "string"
}

Exemplo Corpo da Resposta#

200 - OK
{
    "id_protocolo": 12348,
    "operacao": "cancela",
    "data_recebido": 1711217789710,
    "status": "ok",
}

Dica#

Para mais detalhes sobre o uso deste endpoint, assista ao vídeo mostrando a operação sendo feita pelo Postman aqui.

Atualizar Atributos de Dispositivos#

Nesta operação, o método atualiza os atributos de um vetor de dispositivos. Os atributos a serem atualizados são location e energyConsumption. Para detalhes mais específicos da operação, verifique Atualizar Atributos de Dispositivos
MétodoPATCH
Endpoint/clients/:idInstance/devices
Content-Typeapplication/json

Exemplo Corpo da Requisição#

[
  {
    "idNox": "string",
    "location": {
      "latitude": 90,
      "longitude": 180,
      "altitude": -430
    },
    "energyConsumption": 1
  }
]

Exemplo Corpo da Resposta#

200 - OK
[
  {
    "idNox": "string",
    "location": {
      "latitude": 90,
      "longitude": 180,
      "altitude": -430
    },
    "energyConsumption": 1
  }
]

Atualizar Atributos de um Dispositivo#

Nesta operação, atualiza-se os atributos de um único dispositivo especificado pelo id do Nox. No momento, os atributos disponíveis são location e energyConsumption. Para detalhes mais específicos do endpoint, como parâmetros e outras respostas HTTP, Atualizar Atributos de Dispositivos
MétodoPATCH
Endpoint/clients/:idInstance/devices/:idNox
Content-Typeapplication/json

Parâmetros da URI#

CampoTipoDescrição
idNoxStringIdentificador do Nox

Exemplo Corpo da Requisição#

{
  "idNox": "string",
  "location": {
    "latitude": 90,
    "longitude": 180,
    "altitude": -430
  },
  "energyConsumption": 1
}

Exemplo Corpo da Resposta#

200 - OK
{
  "idNox": "string",
  "location": {
    "latitude": 90,
    "longitude": 180,
    "altitude": -430
  },
  "energyConsumption": 1
}
Modified at 2025-02-26 21:52:17
Previous
3.Autenticação da API
Next
5.Operações de Saída