API remota a través de HTTP
Es posible que desee crear operadores desde su propio sitio y actualizar NxCloud DB automáticamente. Usted puede construir su propio conjunto de API para
tratar con sus operadores de forma remota utilizando DAO y clases de datos de NxCloud.
Para más información sobre las clases DAO y Data, lea Clases DAO y Data
Ejemplo de conjunto API
Tenemos un ejemplo de API en /nxfilter/webapps/example/remoteapi.jsp. Puede llamar a esta página JSP de forma remota a través del protocolo HTTP.
En la página JSP, hay estas acciones se definen,
- createOperator
Puede crear un operador con esta acción. Toma 2 parámetros.
Uno es 'opName' para el nombre del operador. El otro es 'opType' para el tipo de operador que quieres crear,
establece 1 para un operador de tipo comercial y establece 2 para un operador de tipo doméstico. En caso de éxito, devuelve '/OK' y en caso de error, devuelve '/ERR'.
ex) http://localhost/example/remoteapi.jsp?action=createOperator&opName=testname&opType=1
- selectOperator
Esta acción permite obtener información sobre un operador. Toma el parámetro 'opName' para el nombre del operador.
En caso de éxito, devuelve un array JSON con la información del operador.
En caso de error, devuelve '/ERR'.
ex) http://localhost/example/remoteapi.jsp?action=selectOperator&opName=testname
- setExpDate
Permite establecer la fecha de caducidad de un operador. Toma 2 parámetros.
Uno es 'opName' para el nombre del operador. El otro es 'expDate' que es una cadena en formato 'yyyyMMdd' para la fecha de expiración
que desea establecer para filtrar el servicio. En caso de éxito, devuelve '/OK' y en caso de error, devuelve '/ERR'.
ex) http://localhost/example/remoteapi.jsp?action=setExpDate&opName=testname&expDate=20191231
Por defecto, la página JSP de ejemplo sólo acepta llamadas desde 127.0.0.1 o localhost. Tiene que modificar la parte de restricción de la página JPS para aceptar las peticiones de otros hosts.
// Only localhost access allowed.
if(!request.getRemoteAddr().startsWith("127.0.0.1")){
out.println(request.getRemoteAddr());
return;
}
Para hacer estas funciones API remotas, solo usamos las clases DAO y Data de NxFilter. Así que es posible construir otras más complicadas.
Puede tener una ACL basada en IP para sus paginas JSP mediante System > Allowed IP > Allowed IP To GUI.