Tu primera solicitud a la API

Pasa de tu cuenta de IRIS Cloud a tu primera consulta de máquinas en pocos pasos.

Antes de empezar#

Una cuenta de IRIS Cloud con acceso a tu organización.
Un token de API creado en User Account → IRIS Cloud API Tokens. Sigue la guía de tokens.
Un terminal con cURL, o usa la referencia interactiva de la API.

Haz tu primera solicitud#

Guarda tu token en la variable de entorno CONNECT_API_TOKEN. En Bash, el siguiente comando solicita el token sin guardarlo en el historial:

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

Consulta las máquinas disponibles para tu organización:

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

El token se envía en la cabecera Authorization. No lo incluyas en la URL.

Lee la respuesta#

Una solicitud correcta devuelve 200 OK y JSON. Esta respuesta ilustrativa y abreviada muestra el array data:

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

Usa el id de una máquina en las siguientes solicitudes. Un array data vacío indica que la solicitud no devolvió máquinas visibles; no es un error de autenticación. Consulta la referencia para ver el esquema completo de la respuesta.

Descubre los sensores#

Sustituye MACHINE_ID por un ID devuelto en tu consulta de máquinas.

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

A continuación, consulta una vista instantánea o mediciones históricas. Si falla la primera solicitud, usa la guía de solución de problemas.

SIGUE LEYENDOCrear un token de API