fbpx

API IoT & M2M

Consulta en tiempo real los datos almacenados de tus dispositivos IoT

Seguimos innovando para brindarte herramientas que faciliten la integración y el control de dispositivos conectados. Nuestra nueva API RESTful te permite acceder fácilmente a los datos históricos de tus sensores y dispositivos conectados al broker MQTT de Centynova IoT.

  • Monitoreo ambiental (temperatura, humedad, presión, etc.)
  • Dashboards personalizados para control y análisis
  • Automatización industrial y agrícola
  • Proyectos académicos y de investigación
  • Sistemas de alerta y notificaciones inteligentes
  • Respaldo de hasta 10,000 registros

¿Cómo funciona la API?

 Realiza una petición HTTP Method GET para obtener los datos del dispositivo y devuelve un JSON. Desde la siguiente URL:

							
							
					https://mqtt.centynova.com/v1

ParametrosDescripción
x-api-deviceID único del dispositivo
x-api-webClave generada desde tu panel de control.
x-api-topicPara filtrar datos por un tópico específico.

Autenticación:

Para acceder a los datos de tu dispositivo, es necesario autenticarte utilizando dos parámetros obligatorios que debes incluir en la URL de consulta:

  • x-api-device: Este es el ID único del dispositivo IoT que se encuentra registrado en el sistema Centynova IoT.

  • x-api-web: Es la clave privada de autenticación, generada desde tu panel de usuario. Asegúrate de mantenerla segura, ya que permite el acceso completo a los datos de ese dispositivo.

Ambos valores se deben enviar como parámetros en la URL.

							
							
					https://mqtt.centynova.com/v1?x-api-device=0000000&x-api-web=00000000

Recomendaciones de seguridad

  • No compartas tu x-api-web públicamente.
  • Si sospechas que tu clave ha sido comprometida, puedes generar una nueva desde el panel.

Consulta sin tópico:

(Devuelve los topics con los datos más recientes del dispositivo)

							
							
					https://mqtt.centynova.com/v1?x-api-device=0000000&x-api-web=00000000
Respuesta:
							
					[
  {
    "ID_Device": "6973092336",
    "fecha": "2025-04-07T20:47:12.1000000",
    "topic": "sensores/polvo",
    "valor": "461.00"
  },
  {
    "ID_Device": "6973092336",
    "fecha": "2025-04-07T20:47:12.0570000",
    "topic": "sensores/gas",
    "valor": "4095"
  },
  {
    "ID_Device": "6973092336",
    "fecha": "2025-04-07T20:47:12.0230000",
    "topic": "sensores/humedad",
    "valor": "31.0"
  },
  {
    "ID_Device": "6973092336",
    "fecha": "2025-04-07T20:47:11.9770000",
    "topic": "sensores/temperatura",
    "valor": "35.0"
  }
]

Consulta con tópico:

(por ejemplo, humedad)

x-api-topic=sensores/humedad

							
							
					https://mqtt.centynova.com/v1?x-api-device=6973092336&x-api-web=7511442039&x-api-topic=sensores/humedad
Respuesta:
							
					{
  "ID_Device": "6973092336",
  "Topic": "sensores/humedad",
  "data": [
    {
      "data": "31.0",
      "fecha": "2025-04-07T20:47:12.0230000"
    },
    {
      "data": "31.0",
      "fecha": "2025-04-07T20:42:10.1670000"
    },
    {
      "data": "31.0",
      "fecha": "2025-04-07T20:37:08.5430000"
    },
    {
      "data": "31.0",
      "fecha": "2025-04-07T20:32:06.7430000"
    },
    {
      "data": "32.0",
      "fecha": "2025-04-07T20:27:04.8830000"
    },
    {
      "data": "31.0",
      "fecha": "2025-04-07T20:22:03.0570000"
    }
    ]
}

Consulta histórica de todos los tópicos registrados por el dispositivo:

x-api-topic=history

							
							
					https://mqtt.centynova.com/v1?x-api-device=6973092336&x-api-web=7511442039&x-api-topic=history
Respuesta:
							
					[
  {
    "ID_Device": "6973092336",
    "fecha": "2025-04-07T20:47:12.1000000",
    "topic": "sensores/polvo",
    "valor": "461.00"
  },
  {
    "ID_Device": "6973092336",
    "fecha": "2025-04-07T20:47:12.0570000",
    "topic": "sensores/gas",
    "valor": "4095"
  },
  {
    "ID_Device": "6973092336",
    "fecha": "2025-04-07T20:47:12.0230000",
    "topic": "sensores/humedad",
    "valor": "31.0"
  },
  {
    "ID_Device": "6973092336",
    "fecha": "2025-04-07T20:47:11.9770000",
    "topic": "sensores/temperatura",
    "valor": "35.0"
  }
]
Nota: Si no se incluye el parámetro x-api-topic, se devolverán todos los tópicos del dispositivo.

¿Qué pasa si no indico un tópico?

  • Si no incluyes el parámetro x-api-topic, la API devolverá todos los tópicos recientes disponibles del dispositivo, ordenados por fecha y hora.
  • Si utilizas x-api-topic=history, la API te mostrará el histórico completo de todos los tópicos registrados por el dispositivo, desde el primero hasta el más reciente.

Formato de respuesta

Los datos se devuelven en formato JSON, organizados cronológicamente y listos para integrar en tus plataformas o dashboards.

Casos de uso

  • Monitoreo de sensores (temperatura, humedad, presión, gas, etc.)
  • Integración en dashboards web o móviles
  • Automatización de procesos y alertas inteligentes
  • Proyectos académicos y de investigación
  • Estudios de consumo y comportamiento
  • Aprendizaje automático con datos en tiempo real
Ir al contenido