Gracias por desarrollar sobre la plataforma Docuo. Mediante el uso del API de Docuo, o la construcción o distribución de una aplicación que haga uso de la misma, Ud. acepta estos Términos y Condiciones que rigen el acceso y el uso del API de Docuo.
Como desarrollador, le rogamos lea cuidadosamente estos términos antes de invertir su tiempo en desarrollar una aplicación que haga uso del API de Docuo. Usted puede desarrollar usando el API de Docuo solo si es titular de una licencia de Docuo en vigor.
Si no dispone de una licencia propia y está desarrollando con el API de Docuo para una organización, usted manifiesta su acuerdo en cumplir estos Términos y Condiciones y es responsable de tener la autorización de esa organización para realizar el desarrollo en su nombre cumpliendo los mismos. En ese caso, «usted» y «su» se refieren a la organización que dispone de la licencia.
Sus aplicaciones
Una “Aplicación con API Docuo» (en adelante “App Docuo”) es cualquier aplicación que accede a través del API de Docuo a Docuo. Las Apps Docuo deben cumplir con las políticas de Docuo y los requisitos establecidos en este documento, así como con cualquier otra documentación contractual firmada, o documentación técnica proporcionada por R2 Sistemas.
Usted debe solicitar autorización a R2 Sistemas para desarrollar una App Docuo y hacer uso de las diferentes APIs. Podemos rechazar esas peticiones o incluso revocar una autorización concedida con anterioridad si creemos que usted está violando estos términos y condiciones en forma o fondo, está tratando de encubrir un uso abusivo contra la política de licencias del producto, o pensamos que su App Docuo es de cualquier manera perjudicial para R2 Sistemas y los usuarios de Docuo.
Consumo de Créditos Docuo
El uso del API puede suponer el consumo de créditos Docuo en su licencia al realizar llamadas, de acuerdo a los términos y condiciones de uso del producto. Puede consultar el detalle de los precios de Docuo en el siguiente enlace:
Acciones prohibidas
Usted y su App Docuo, no deben:
Realizar acciones en contra de una política de uso aceptable, tales como llamadas masivas a las APIs, pruebas iterativas de estrés o cualquier otra acción automatizada que pueda interpretarse como una amenaza para la disponibilidad del servicio.
Utilizar el API de Docuo sin implementar un mecanismo propio de autenticación de usuarios en su aplicación. Por ejemplo, una página web abierta que ofrezca una descarga directa de un documento Docuo, o un listado de documentos de Docuo, sin preguntar antes usuario y contraseña de su propia App.
Utilizar mecanismos destinados a vulnerar la política de licencias del producto, tales como utilización compartida de secretos y/o tokens de acceso de un usuario Docuo por parte de múltiples usuarios de su aplicación, sin el consentimiento escrito de R2 Sistemas.
Utilizar el nombre de Docuo, marcas comerciales, logotipos o elementos de imagen corporativa de Docuo sin el consentimiento escrito de R2 Sistemas.
Uso correcto del API
Salvo autorización escrita por parte de R2 Sistemas en sentido contrario:
Una autorización oAuth (user_id, user_secret, token de acceso) de un usuario nominal Docuo para su aplicación, autoriza las llamadas al API de un único usuario nominal de su App.
Queda prohibido compartir una única autorización oAuth Docuo con dos o más usuarios nominales de su App Docuo.
Si cree que su App Docuo necesita hacer esto, por favor contacte con el equipo de Docuo antes de programarlo para estudiar una solución alternativa o autorizar este uso del API mediante la elaboración de un acuerdo específico (SLA) que incluya una cuenta proxy preparada para tráfico concurrente.
Compartir un mismo token de acceso entre varios usuarios de su app, realizar accesos concurrentes con el mismo token, o generarlo para varios usuarios de su app con el mismo user_id y user_secret sin autorización de R2 Sistemas, puede llevar a la revocación definitiva de su autorización de desarrollo sin previo aviso.
R2 Sistemas puede limitar el número de llamadas aceptadas por el API si creemos que el número de llamadas puede influir negativamente en la API de Docuo o el servicio Docuo.
El API de Docuo y el propio producto, es un trabajo en constante progreso. Usted debe tener esto en mente: van a producirse cambios en el producto y el API a medida que refinemos y añadamos más características al producto, siempre con las necesidades de nuestros usuarios y desarrolladores en mente.
Límites del API
Por defecto, el uso del API está sujeto a unos límites operativos que se explican a continuación. Algunos de estos límites se pueden ampliar mediante créditos, otros mediante un acuerdo específico (SLA) y otros no son modificables.
Si considera que estos límites son insuficientes para el desarrollo de su App R2 Docuo, puede solicitar a nuestro equipo mediante un ticket de soporte, la valoración económica de un acuerdo específico (SLA) con los límites que precise.
Cuenta dedicada
La App Docuo deberá utilizar una cuenta R2 Docuo dedicada para el tráfico API. La cuenta utilizada para este propósito:
- Debe ser una cuenta sin privilegios de administración.
- La cuenta perderá la capacidad de iniciar sesión en R2 Docuo.
Si se intenta utilizar la cuenta dedicada para el API en los clientes R2 Docuo Windows, web, iOS o Android, o cualquier otro que se habilite en el futuro, el sistema mostrará un mensaje de error.
Límite de ráfaga (burst)
El sistema impedirá que, en el plazo de un segundo, se efectúe un número de llamadas superior a:
- Límite general: 10 llamadas por segundo
- Llamadas al API de búsqueda: 4 llamadas por segundo
Si se intentan realizar más de este número de llamadas, el API devolverá un código indicativo de error (“burst limit exceded”).
Límite mensual de llamadas (base fija + flexible con créditos)
El número total de llamadas al API se reestablece el día 1 de cada mes a las 00:00 h CET/CEST. Partiendo de la base de que el API esté disponible (Ediciones Business y Enterprise de R2 Docuo), se establece el siguiente límite:
- Llamadas al API: 5.000 llamadas al mes
Este límite puede incrementarse de forma puntual mediante el consumo de créditos R2 Docuo tal y como se explica en la página de precio del producto. Si el límite se supera y no hay saldo de créditos para adquirir un paquete de llamadas adicionales el API devolverá un código indicativo de error (“API call monthly limit exceded”).
Límite mensual de descarga de archivos
El límite de descarga de archivos se reestablece el día 1 de cada mes a las 00:00 h CET/CEST. Se entiende como volumen de descarga de archivos la suma del tamaño de todos los archivos descargados utilizando las diferentes llamadas del API que permiten esta finalidad durante el mes en curso. Se establece el siguiente límite.
- Límite de descarga de archivos: 1 GB al mes
Si el límite se supera, el API devolverá un código indicativo de error (“Monthly download limit exceded”).
Límite mensual de descarga de datos
El límite de descarga de datos se reestablece el día 1 de cada mes a las 00:00 h CET/CEST. Se entiende como volumen de descarga de datos la suma del tamaño de todas las respuestas del API que no son de descarga de archivos (típicamente en formato JSON) durante el mes en curso. Se establece el siguiente límite.
- Límite de descarga de datos: 1 GB al mes
Si el límite se supera, el API devolverá un código indicativo de error (“Monthly data download limit exceded”).
Máximo número de filas por página (max top)
Las llamadas al API de R2 Docuo que devuelven una lista de resultados, permiten establecer un límite de filas para la respuesta por encima del cual se fuerza una paginación de la llamada. Se establece el siguiente límite.
- Máximo número de filas por consulta: 1.000 filas
Si se efectúa una llamada que deba devolver más de este número de filas, se devolverá el número autorizado de resultados y se ignorará el resto, que deberá obtenerse en otra llamada.
Aprobación de su App Docuo
Cuando usted comienza a desarrollar una nueva App Docuo, se considera en estado “en desarrollo”. Las funcionalidades del API serán las mismas que en el estado “en producción”, salvo por un límite de 5 autorizaciones oAuth para la misma.
En el estado “en desarrollo” usted puede construir su App Docuo y llevar a cabo pruebas piloto de su funcionamiento, no obstante se compromete a no utilizar su App Docuo en entornos de producción hasta que no haya sido aprobada.
Una vez finalizado el desarrollo, usted puede solicitar a R2 Sistemas pasar su App Docuo al estado “en producción”. Antes de cursar esta solicitud, por favor asegúrese de que su App Docuo cumple con los términos y condiciones, ya que su solicitud será rechazada si no lo hace.
De cara a la aprobación de su App Docuo, R2 Sistemas puede solicitar todo o parte del código fuente de su App Docuo, así como usuarios de prueba para comprobar su funcionalidad y el correcto uso del API de Docuo.
Otras plataformas
Usted es completamente responsable de cualquier interacción de su App Docuo con otras plataformas, productos y sistemas operativos.
Usted no debe indicar o publicitar la compatibilidad de Docuo con otros productos o servicios sin autorización. Por ejemplo, usted no puede publicitar su App Docuo en su website como “compatible con Docuo” sin autorización de R2 Sistemas.
Datos personales del usuario final
Si se lleva a cabo recolección de información personal a través de su App Docuo, usted debe asegurarse de que esta información se recopila, procesa, transmite, mantiene y utiliza de acuerdo con todas las leyes aplicables en España, Europa y en su país, así mismo debe publicar una política propia de privacidad que ponga a disposición de los usuarios de su App Docuo.
Usted debe cumplir con los términos y condiciones de su política de privacidad y emplear medidas razonables para proteger la información personal que recopile mediante el API de Docuo.
Duración y Terminación
R2 Sistemas puede rescindir su acceso a parte o la totalidad del API de Docuo por: (a) la infracción de cualquier disposición de estos términos y condiciones; (b) requerimiento legal a R2 Sistemas; (c) si R2 Sistemas deja de ofrecer cualquier servicio relacionado con todo o parte del API o (d) por cualquier otra razón con 30 días de aviso previo por escrito a usted.
Renuncia
LOS SERVICIOS DE API DE DOCUO SE OFRECEN «TAL CUAL», PARA LA UTILIZACIÓN BAJO SU PROPIO RIESGO, SIN GARANTÍA EXPRESA O IMPLÍCITA, SIN GARANTÍA DE IDONEIDAD PARA UN PROPÓSITO PARTICULAR O DE NO INFRACCIÓN DE CUALQUIER REQUERIMIENTO LEGAL.
Modificación
Podemos revisar estos Términos y Condiciones del uso del API eventualmente. Esta página siempre contendrá la versión más actualizada de los mismos. Al continuar accediendo o utilizando el API de Docuo tras un cambio de condiciones, usted acepta que quedará vinculado por los Términos revisados. Si usted no acepta los nuevos términos, por favor, deje de utilizar el API de Docuo.