Capacidades de Integración e Interoperabilidad de Athento [FAQs]

Hoy continuamos respondiendo algunas de las preguntasde nuestros usuarios.

1. ¿Es posible hacer llamadas desde una aplicación .Net a Athento para obtener información que pueda ser utilizada desde la misma?

Esta pregunta la ha realizado nuestro amigo José Ángel Pereiras de Header en Barcelona.

José Ángel, la respuesta es sí. Existe un conjunto de web services  proporcionados por Athento y que son independientes de la aplicación que los llama. En la actualidad, estos web services siguen la arquitectura REST y han sido desarrollados con el framework para JAVA de RESTful (Restlet). Básicamente, REST permite manejar y transportar recursos a través de HTTP (de la web). Dentro de poco, Athento también contará con web services SOAP.

Os voy a quedar debiendo un vídeo del funcionamiento de web services que pronto tendremos, pero de momento, voy a explicarlo con una captura de pantalla.

Para probar cómo funcionan los web services, vamos a utilizar el cliente REST  de Google Chrome, POSTMAN.

El servicio al que vamos a llamar es:

http://cloud.athento.com/athento/rest/input/capture/uploadDocument/xml

Este web service nos sive para subir documentos al capture, por ejemplo desde otras aplicaciones. Es de tipo POST lo que significa que los parámetros no se muestran en la URL. Para enviar un fichero a Athento, vamos a necesitar indicar algunos parámetros:

• file: El archivo
• title: El título que debe llevar en Athento
• fileName: El nombre del archivo
• mimeType: El tipo del archivo
• requestId: Podemos utilizar este número para identificar la operación

En Postman indicamos la url que llama el web service, los parametros y el método. 

Una vez indicamos todo lo anterior, hacemos clic en "Send" para que se ejecute la llamada a Athento.

En la parte inferior de la ventana del Postman, se mostrará la respuesta de la llamada al web service. En este caso, Athento nos dice que la subida se realizo "OK"  y nos devuelve el id (value 2) del documento que Athento ha guardado en su repositorio interno.

En este caso hemos visto cómo subir documentos, pero también hay servicios para obtener datos de documentos, por ejemplo:

http://capture.athento.com/athento/rest/input/capture/extractCoordinates/xml 
Con este web service podemos indicar una palabra que sabemos que el documento contiene y pedirle a Athento que nos devuelva las coordenadas físicas del documento en las que esta palabra aparece. 

http://capture.athento.com/athento/rest/input/capture/queryDocument/xml

Con este web service puedo obtener el tipo de documento y los metadatos extraídos por Athento.

Estamos trabajando en tener una API más compleja que permita una completa interacción con Athento desde cualquier aplicación.

Nota: Para hacer uso de los web services de Athento se necesita autenticación en la plataforma como administrador. Los web services disponibles pueden consultarse desde:

 

http://capture.athento.com/athento/component.faces?action=ADMINISTRATION_INFO_MENU_ACTION

Para más información sobre cómo probar los web services de Athento, visita nuestro Documentation Center.