A continuación se describen operaciones básicas mediante la API del gestor documental que pueden ser útiles para realizar integraciones con el mismo:
Info | ||
---|---|---|
| ||
$ATHENTO_HOST es el valor del dominio donde se encuentra desplegada la instancia de Athento ECM. |
Autenticación y cabeceras
Para autenticar los servicios descritos a continuación es necesario establecer el usuario y contraseña que serán incluidas mediante BasicAuthentication en las cabeceras de la petición.
Ejemplo en el cliente POSTMAN para Chrome:
Además, para poder realizar correctamente todas las peticiones a servicios, es necesario introducir la siguiente cabecera:
Content-Type: application/json+nxrequest
Ejemplo en el cliente POSTMAN para Chrome:
Ejemplo de petición autenticada con la cabecera:
Consultar los tipos documentales disponibles en el sistema
...
Code Block | ||
---|---|---|
| ||
http://localhost$ATHENTO_HOST/nuxeo/api/v1/config/types |
...
Obtener el tipo documental de un documento
Este servicio nos devuelve toda la información de estructura con contenido de un documento existente en el sistema dado su identificador.
Code Block | ||
---|---|---|
| ||
http://localhost$ATHENTO_HOST/nuxeo/restAPI/default/{docId}/export?format=XML |
...
Obtener los metadatos para un tipo documental concreto
Este servicio nos devuelve la estructura de metadatos y facetas de un tipo documental concreto.
Code Block | ||
---|---|---|
| ||
http://localhost$ATHENTO_HOST/nuxeo/api/v1/config/types/{docType} |
...
Code Block | ||
---|---|---|
| ||
http://localhost$ATHENTO_HOST/nuxeo/api/v1/id/{docId} |
B) Por su path
Code Block | ||
---|---|---|
| ||
http://localhost$ATHENTO_HOST/nuxeo/api/v1/idpath/{docPath} |
Info | ||
---|---|---|
| ||
Debes utilizar el path a partir de /default/ |
Obtener el preview de un documento
...
Code Block | ||
---|---|---|
| ||
http://localhost$ATHENTO_HOST/nuxeo/restAPI/preview/default/{docId}/files:files-0-file/ |
...
Code Block | ||
---|---|---|
| ||
http://localhost$ATHENTO_HOST/nuxeo/restAPI/default/{docId}/deleteDocument |
...
Code Block | ||
---|---|---|
| ||
http://localhost$ATHENTO_HOST/nuxeo/restAPI/default/{parentDocId}/createDocument?docType={docType}&dublincore:title={title} |
...
Code Block | ||
---|---|---|
| ||
PUT /nuxeo/site/api/v1/id/{docId} { "entity-type": "document", "repository": "default", "uid": "37b1502b-26ff-430f-9f20-4bd0d803191e", "properties": { "dc:title": "The new title", "dc:description": "Document updated via REST API" "common:icon": "/icons/file.gif", "common:icon-expanded": null, "common:size": null } } |
Hacer consultas
Code Block | ||
---|---|---|
| ||
http://localhost$ATHENTO_HOST/nuxeo/api/v1/query/?query={queryNXQL} |
...
Code Block | ||
---|---|---|
| ||
http://localhost$ATHENTO_HOST/nuxeo/api/v1/query/?query=SELECT * FROM Document WHERE dc:title='ATHENTO' |
...
Vemos que el sistema ha encontrado dos documentos cuyo título es "ATHENTO" y nos ha devuelto sus propiedades.
Más Operaciones
Tip | ||
---|---|---|
| ||
Para mayor información, te recomendamos descargar el manual de la API de Athento, disponible desde: |