Sua primeira requisição à API

Vá da sua conta IRIS Cloud à primeira consulta de máquinas em poucos passos.

Antes de começar#

Uma conta IRIS Cloud com acesso à sua organização.
Um token de API criado em User Account → IRIS Cloud API Tokens. Siga o guia de tokens.
Um terminal com cURL, ou use a referência interativa da API.

Faça sua primeira requisição#

Disponibilize seu token na variável de ambiente CONNECT_API_TOKEN. No Bash, o comando abaixo solicita o token sem registrá-lo no histórico de comandos:

read -r -s -p 'Connect API token: ' CONNECT_API_TOKEN
printf '\n'
export CONNECT_API_TOKEN

Consulte as máquinas disponíveis para sua organização:

curl --request GET \
  --url 'https://connect-api.iris-cloud.netzsch.com/api/v1/machines' \
  --header "Authorization: Bearer $CONNECT_API_TOKEN" \
  --header 'Accept: application/json'

O token é enviado no cabeçalho Authorization. Não o coloque na URL.

Leia a resposta#

Uma requisição bem-sucedida retorna 200 OK e JSON. Esta resposta ilustrativa e resumida mostra o array data:

{
  "data": [
    {
      "id": "machine-example",
      "name": "Production mill",
      "status": "IDLE"
    }
  ]
}

Use o id de uma máquina nas próximas requisições. Um array data vazio indica que a requisição não retornou máquinas visíveis; não é um erro de autenticação. Consulte a referência para ver o schema completo da resposta.

Descubra os sensores#

Substitua MACHINE_ID por um ID retornado na consulta de máquinas.

curl 'https://connect-api.iris-cloud.netzsch.com/api/v1/machines/MACHINE_ID/sensors' \
  --header "Authorization: Bearer $CONNECT_API_TOKEN"

Em seguida, consulte uma visão instantânea ou medições históricas. Se a primeira requisição falhar, use o guia de solução de problemas.

CONTINUE LENDOCriar um token de API