| Referencia de la API 2.2 de Cube Panel: Acceso a los servicios web de Cube Panel | ||
|---|---|---|
| Anterior | Capítulo 1. Introducción | Siguiente |
Librería de acceso a la API de Web Services de CUBE. Se puede descargar aquí.
La librería de acceso incluye también las siguientes librerías que son necesarias para acceder a los servicios web:
Esta clase proporciona acceso a un servidor Cube Panel y configura la conexión. Su constructor tiene la siguiente definición:
WSAccess access = new WSAccess(user_name, password, wsdl_url, endpoint, id_language)
user_name : Nombre de usuario de máximos privilegios con el que se quiere invocar a los servicios web
password : contraseña del usuario
wsdl_url : URL del fichero WSDL que describe los servicios web del servidor Cube Panel. Se recomienda tener una copia en un fichero en el cliente que invoca a los servicios web. Para obtenerla, basta con acceder con un navegador a la url https://cubepanelhost:25112/modules/cubeservices.php?wsdl. El usuario y contraseña que pedirá la autenticación será "admin" y la contraseña de dicho usuario.
endpoint : URL del punto de acceso a los servicios web del servidor Cube Panel (https://cubepanelhost:25112/modules/cubeservices.php)
id_language : Identificador del idioma en que se quiere obtener las respuestas de los servicios web
Una vez obtenida una instancia de la clase WSAccess, es necesario obtener una instancia de un objeto CubePanelWSBindingStub. Se puede obtener mediante el método getUser de la clase WSAccess:
WSAccess a = new WSAccess("admin", "123456",
"file:///C:/cubeservices/cubeservices.wsdl", "https://127.0.0.1:25112/modules/cubeservices.php",
WSAccess.CUBE_PANEL_LANG_ENGLISH);
CubePanelWSBindingStub bs = a.getUser("admin");
ClientInfo clients[] = bs.ADMINCLIENTS_GetClients(null, null, null);
El parámetro que se pasa al método getUser indica el usuario con el que se va a realizar la operación.
La clase WSAccess incorpora también los siguientes métodos:
void setTimeOut(int seconds) : permite especificar el tiempo máximo de espera para conectarse al servidor (en segundos).
Date UnixTimestamp2Date(int timestamp) : convierte una fecha en formato UNIX Timestamp a un objeto Date de Java.
Y las siguientes constantes:
CUBE_PANEL_LANG_SPANISH : Identificador del idioma Español
CUBE_PANEL_LANG_ENGLISH : Identificador del idioma Inglés
CUBE_PANEL_LANG_GERMAN : Identificador del idioma Alemán
CUBE_PANEL_LANG_FRENCH : Identificador del idioma Francés
CUBE_PANEL_LANG_PORTUGUESE : Identificador del idioma Portugués
CUBE_PANEL_ORDER_ASC : Identificador para indicar ordenación ascendente de los resultados.
CUBE_PANEL_ORDER_DESC : Identificador para indicar ordenación descendente de los resultados.
CUBE_PANEL_CURRENCY_EUR : Identificador de la divisa Euro.
CUBE_PANEL_CURRENCY_USD : Identificador de la divisa Dólar de EEUU.
CUBE_PANEL_DNS_RECORD_TYPE_A : Identificador de entrada DNS de tipo A.
CUBE_PANEL_DNS_RECORD_TYPE_CNAME : Identificador de entrada DNS de tipo CNAME.
CUBE_PANEL_DNS_RECORD_TYPE_NS : Identificador de entrada DNS de tipo NS.
CUBE_PANEL_DNS_RECORD_TYPE_MX10 : Identificador de entrada DNS de tipo MX10.
CUBE_PANEL_DNS_RECORD_TYPE_MX20 : Identificador de entrada DNS de tipo MX20.
CUBE_PANEL_FTP_QUOTA_UNLIMITED : Identificador de cuota ilimitada para cuentas de FTP.
CUBE_PANEL_FTP_READ_ONLY : Identificador de "sólo lectura" para cuentas de FTP.
CUBE_PANEL_FTP_READ_WRITE : Identificador de "lectura/escritura" para cuentas de FTP.
CUBE_PANEL_RESOURCE_TRAFFIC : Identificador del recurso "Tráfico".
CUBE_PANEL_RESOURCE_ACTIVE_DOMAINS : Identificador del recurso "Dominios activos".
CUBE_PANEL_RESOURCE_MAILBOXES : Identificador del recurso "Buzones de correo".
CUBE_PANEL_RESOURCE_MAILALIASES : Identificador del recurso "Redirecciones de correo".
CUBE_PANEL_RESOURCE_MYSQL_DBS : Identificador del recurso "Bases de datos de MySQL".
CUBE_PANEL_RESOURCE_FTP_ACCOUNTS : Identificador del recurso "Cuentas de FTP".
CUBE_PANEL_RESOURCE_INBOUND_TRAFFIC : Identificador del recurso "Tráfico entrante".
CUBE_PANEL_RESOURCE_OUTBOUND_TRAFFIC : Identificador del recurso "Tráfico saliente".
CUBE_PANEL_RESOURCE_DISK_USAGE : Identificador del recurso "Espacio en disco".
CUBE_PANEL_RESOURCE_SQL_SERVER_DBS : Identificador del recurso "Bases de datos SQL Server".
CUBE_PANEL_RESOURCE_ACTIVE_CLIENTS : Identificador del recurso "Clientes activos".
CUBE_PANEL_RESOURCE_CLIENTS : Identificador del recurso "Clientes creados".