IoT Input

Hay dos endpoints que puede usar: Endpoint 1: /iot/\/action

Toma parámetros application/x-www-form-urlencoded: passphase, value (donde value es un objeto JSON)

• Crear un Device en IoT \> Config Devices
• Acceder a la sección Inputs del device
• Crear un input. Debe definir un serial, passphrase, function y model

La función que el sistema llamará debe ser del siguiente tipo:

@api.model def call_function(self, key): return {}

Donde key es la cadena de input enviada por el device y el resultado debe ser un diccionario que se responderá al device como JSON.

Endpoint 2: /iot/\/multi_input Se puede usar para enviar valores con múltiples datos en una sola petición POST como: - Valores para inputs del mismo device con distinta address (multi input) - Valores para inputs del mismo device con la misma address, distintos values (multi event) - Mezcla de los anteriores (multi input, multi event)

Toma parámetros application/x-www-form-urlencoded: passphase, values (un array JSON de objetos JSON)

Se llama usando device_identification y pasando dos parámetros POST: device passphrase y una cadena JSON que contiene un array de values para input - El valor para la key address puede ser una cadena o un numérico (para conservar bytes en dispositivos con memoria restringida al crear el objeto JSON) y se convierte a cadena al parsear. - El valor para la key value puede ser cadena, número o booleano según las especificaciones de JSON. Puede ver un ejemplo de un objeto JSON de input válido en la carpeta de ejemplos, usando algunas combinaciones.

Requiere que la función que el sistema llamará debe ser del siguiente tipo:

@api.model def call_function(self, key): 'do something if err: return {'status': 'error', 'message': 'The error message you want to send to the device'} return {'status': 'ok', 'message': 'Optional success message'}

Donde key es un dict enviado por el device que tiene al menos value para las keys: 'address', 'value'

La función debe devolver siempre un JSON con status y message. Si value contiene un valor con 'uuid' como key, se devuelve junto con el objeto para que el dispositivo IoT identifique éxito/fallo por registro.

Tiene reporte de errores completo y el valor de retorno es un array JSON de dicts que contienen al menos status y message. La respuesta del mensaje de error es en algunos puntos genérica, aunque se realiza un logging extendido en los logs del servidor de Odoo.