5.4.5 HTTP API

HTTP API es una interfaz de aplicación para controlar las funciones determinadas del intercomunicador mediante el protocolo HTTP. Esta interfaz permite integrar de forma sencilla los intercomunicadores 2N IP con productos de terceros, por ej. sistemas de automatización doméstica, sistemas de seguridad y de monitorización de edificios etc.

Services

HTTP API está dividido según su función entre los siguientes servicios:

  • API de sistema – permite cambios de configuración, obtención del estado y upgrade del intercomunicador.
  • Administración del accesos API – permite controlar los accesos y la forma de verificar la autenticación del usuario.
  • API de interruptor – permite controlar y vigilar el estado de los interruptores, por ej. apertura de las cerraduras de puertas, etc.
  • API de E/S – permite controlar y vigilar las entradas y salidas lógicas del intercomunicador.
  • Audio API – permite controlar la reproducción de los sonidos y monitorear el micrófono del dispositivo.
  • API de cámara – permite controlar y vigilar la imagen de la cámara.
  • API de pantalla – permite controlar la pantalla y visualizar la información de usuario en la pantalla.
  • API de e-mail – permite enviar desde el dispositivo los e-mails de usuario.
  • API de teléfono/llamada – permite controlar y vigilar las llamadas entrantes y salientes.
  • API de registro – permite leer los sucesos registrados en el dispositivo.
  • API de automatización – permite configurar la comunicación Secure/Unsecure y los requisitos de autorización.

para cada servicio se puede configurar un protocolo de transporte (HTTP o HTTPS) y la forma de autenticación (ninguna, Basic o Digest). En la configuración HTTP API se puede crear hasta cinco cuentas de usuario (con nombre y contraseña propios) con la posibilidad de controlar detalladamente el acceso a cada uno de los servicios y funciones.

En cada servicio se puede configurar la forma requerida de autenticación de las solicitudes enviadas al intercomunicador. En el caso de que no se realice la autenticación, la solicitud es rechazada. Las solicitudes están siendo autenticadas mediante el protocolo de autenticación estándar descrito en RFC-2617. Se pueden elegir estos tres métodos de autenticación:

  • Ninguna – el servicio no requiere ninguna autenticación. En este caso el servicio está totalmente desprotegido en la red local.
  • Basic – el servicio requiere autenticación Basic según RFC-2617. En este caso el servicio requiere la contraseña, sin embargo, ésta está siendo enviada en formato abierto. Recomendamos combinar esta opción con el protocolo HTTPS, si es posible.
  • Digest – el servicio requiere autenticación Digest según RFC-2617. Esta variante es inicial y es la más segura de los métodos mencionados anteriormente.

La descripción detallada de la función y de la configuración de HTTP API está disponible en el manual HTTP API. 

Consejo

  • Para la función Video Preview en el teléfono Gigaset Maxwell 10 es necesario en la solapa HTTP API junto al elemento Camera API configurar el Tipo de conexión = No asegurada (TCP) y Autenticación = Ninguna.

Cuenta 1–2

El intercomunicador 2N IP permite administrar hasta cinco cuentas de usuario destinados al acceso a los servicios HTTP API. Una parte de la cuenta de usuario forma el nombre y la contraseña del usuario y la tabla de los derechos de acceso del usuario a cada uno de los servicio HTTP API.

  • Cuenta habilitado – permite esta cuenta de usuario.

  • Nombre de usuario – introduzca el nombre de usuario para autenticar con el HTTP API.
  • Contraseña – introduzca la contraseña de autenticación de la HTTP API.

Con la ayuda de la tabla de derechos de acceso se pueden gestionar los privilegios de la cuenta de usuario a cada uno de los servicios.