API MQTT de ForoElectro.Net

API para publicar un mensaje MQTT:

URL:

https://www.foroelectro.net/arduino/api/<ApiKey>/mqtt/publish

http://www.foroelectro.net/arduino/api/<ApiKey>/mqtt/publish

Parameters:

All parameters can be passed in any method (GET, POST, etc).

• message - Mensaje a enviar.
• client - Opcional. Nombre del cliente. Por defecto es ForoElectroNetAPI
• topic - Opcional. Extra del nombre del topic (recuerda que tu ApiKey es el prefijo de cualquier topic)
• f - Opcional. Formato de salida. Si añades f=json la respuesta se dará en JSON; en cualquier otro caso se dará en texto.

Return:

Modo texto:

• 1 - Everything has worked properly.
• 0|<error> - Error. Tras el símbolo '|' hay una breve descripción.

Modo JSON:

{

• "result": 1 si todo ha funcionado correctamente, 0 si hay error
• "error": Sólo existe si el resultado es 0; breve descripción del error.

}

API para revisar mensajes MQTT:

URL:

https://www.foroelectro.net/arduino/api/<ApiKey>/mqtt/get

http://www.foroelectro.net/arduino/api/<ApiKey>/mqtt/get

Parameters:

All parameters can be passed in any method (GET, POST, etc).

• wait - Opcional. Segundos de espera de la llamada si no hay mensajes.
• last - Opcional. Id numérica del último mensaje ya leido.

Return:

El formato de salida es siempre JSON:

{

• "result": 1 si todo ha funcionado correctamente, 0 si hay error
• "error": Sólo existe si el resultado es 0; breve descripción del error.
• "data": Sólo existe si el resultado es 1; Array de mensajes: [
  • {
  • • "utime": UNIX timestamp del mensaje.
    • "payload": Mensaje.
    • "topic": Topic completo del mensaje.
  • }
  }

}

Antes de usar la API MQTT:

First you have to create an Application. You will need 2 fields: Name and email. After this you get an ApiKey.

How to get an ApiKey?

Para crear tu ApiKey se requieren 2 campos: Nombre y email.

You can use API with your ApiKey or login in this site using also your email to view your data.

Yoiu can create as much applications as youn want with same email, each one will have its own ApiKey.

You can change email or Application, your ApiKey will not change.