Aprenda a configurar la configuración del dispositivo a través de la API HTTP con Postman, incluido el registro SIP, las claves DSS, las opciones de red, el formato de solicitud XML y la recuperación de parámetros compat
Esta guía explica cómo configurar los parámetros del dispositivo a través de la API HTTP, incluyendo la configuración del servidor SIP, los detalles de registro de la cuenta SIP, los parámetros de la tecla DSS y otras opciones del dispositivo. El dispositivo actúa como servidor HTTP, mientras que el cliente envía solicitudes HTTP específicas para aplicar los cambios de configuración, como se muestra en el diagrama siguiente.
En este ejemplo, se utiliza Postman para simular las solicitudes HTTP enviadas al dispositivo.
Todos los modelos de teléfono actualmente disponibles en nuestra línea de productos.
① Un dispositivo de interfono BHP-SOS11V, actualizado a la última versión de firmware y conectado a un conmutador PoE.
② Un PC de configuración con Postman instalado, conectado al mismo conmutador, con comunicación de red normal confirmada.
Descargue Postman desde:
https://www.postman.com/downloads/
Luego siga las instrucciones de instalación para completar la configuración.
Haga clic en File – New, luego seleccione HTTP Request.
En la ventana de nueva solicitud, seleccione el método POST e ingrese la URL HTTP del dispositivo en el siguiente formato:
http://ip/xmlservice
Tenga en cuenta que la URL distingue entre mayúsculas y minúsculas. Reemplace ip con la dirección IP real del dispositivo, como se muestra a continuación.
Luego configure los parámetros de solicitud HTTP requeridos:
Método de autenticación: Basic Auth
Encabezado: Content-Type: xml/text
Haga clic en Body, seleccione raw, luego ingrese el contenido XML en el cuerpo del mensaje. A continuación se muestra un formato de ejemplo.
La estructura es la siguiente:
Esta es la cabecera de declaración XML y es requerida en cada solicitud.
Esto define la estructura del comando XML. El atributo cmd puede ser get para recuperar los parámetros actuales o set para escribir nuevos parámetros.
Esto especifica el elemento de configuración real. En este ejemplo, la solicitud recupera los parámetros relacionados con la línea SIP del dispositivo.
En el uso real, la siguiente sección debe ajustarse según el parámetro real que desee consultar o configurar:
Diferentes modelos pueden admitir diferentes parámetros de la API HTTP. Puede utilizar cualquiera de los siguientes métodos para obtener la lista de parámetros admitidos para un dispositivo específico.
Método 1: En la interfaz WEB del dispositivo, vaya a System – System Configuration, luego exporte el archivo de configuración de tipo nc.
Puede hacer clic derecho para guardar el archivo, o hacer clic izquierdo para ver la configuración directamente. Los parámetros comunes se enumeran en la siguiente sección.
Método 2: Algunos modelos no proporcionan el enlace del archivo de configuración nc directamente en la interfaz web. En ese caso, puede ingresar la URL correspondiente en la barra de direcciones del navegador para recuperar el archivo de configuración nc manualmente.
Nota: Este método puede tardar más en responder.
Esta sección enumera varios parámetros comunes como referencia. Se pueden agregar más parámetros en futuras actualizaciones.
Ejemplo de parámetros de línea SIP (del dispositivo de control de acceso i30):
sip.line.1.PhoneNumber = 112
sip.line.1.DisplayName = 112
sip.line.1.SipName =
sip.line.1.RegAddr = 172.18.1.45
sip.line.1.RegPort = 2066
sip.line.1.RegUser = 112
sip.line.1.RegPswd = abc123
sip.line.1.RegTTL = 3600
sip.line.1.RegEnabled = 0
sip.line.1. indica que estos parámetros pertenecen a la línea SIP 1.
PhoneNumber corresponde al campo de número de teléfono en la interfaz web.
DisplayName corresponde al nombre mostrado.
RegAddr es la dirección del servidor proxy SIP.
RegPort es el puerto del servidor proxy SIP.
RegUser es el nombre de usuario de autenticación, generalmente el mismo que el número de teléfono.
RegPswd es la contraseña.
RegTTL es el tiempo de caducidad del registro, con un valor predeterminado de 3600 segundos.
RegEnabled define si la línea está habilitada: 0 significa deshabilitada, 1 significa habilitada.
Ejemplo de parámetros de tecla DSS para el i30:
Se recomienda configurar la tecla DSS primero en la interfaz web, luego usar la API HTTP con el comando get para leer los valores de los parámetros correspondientes y confirmar la asignación exacta.
Type=1 indica que el tipo de tecla DSS es Hotkey para dispositivos como el i30 o i12. Para otros modelos, verifique el valor de tipo real utilizando el método recomendado anteriormente.
Value=125@1/f significa:
125 = número de destino
@1 = línea 1
/f = subtipo: marcación rápida
Ejemplo de parámetros de red para dispositivos como el i30 y i12:
WANMode indica el modo de red, que puede ser DHCP o static. Este parámetro no se puede escribir directamente con el comando set. Cambia automáticamente según el valor de dhcp.Enabled.
static.IP es la dirección IP estática. Solo es efectiva cuando el dispositivo está en modo estático. En modo DHCP, el comando get aún se puede usar para recuperar la dirección IP actual.
static.SubnetMask es la máscara de subred.
static.Gateway es la puerta de enlace predeterminada.
static.PrimaryDNS es el servidor DNS principal.
static.SecondaryDNS es el servidor DNS secundario.
dhcp.Enabled define si DHCP está habilitado: 1 significa que el modo DHCP está activo, mientras que 0 significa que se utiliza el modo de IP estática.
Ejemplo de parámetros de volumen para el BHP-SOS11V:
phone.volume.HandFreeVol es el volumen del altavoz. El rango es 1-9, donde 9 es el volumen más alto.
phone.volume.HandFreeRingVol es el volumen del tono de llamada para llamadas entrantes. El rango es 1-9, donde 9 es el volumen más alto.
phone.volume.HandFreeToneVol es el volumen de los tonos de aviso, como alertas y sonidos de notificación. El rango es 1-9, donde 9 es el volumen más alto.
Los parámetros de información del sistema son de solo lectura, lo que significa que solo se pueden consultar con el comando get.
Ejemplo:
Este parámetro devuelve toda la información del sistema. Si solo necesita un elemento específico, extienda la ruta del parámetro al siguiente nivel de nodo.
Por ejemplo, para obtener la dirección MAC del dispositivo:
