Condiciones de la API para agencias
Última actualización: 16 de noviembre de 2026
Publicada el 16 de noviembre de 2026 · se aplica desde el 16 de noviembre de 2026 · empeora tus condiciones o rompe lo que tu programa ya hace: desde esa fecha, y hasta que la aceptes en el panel de agencia, tus keys dejan de funcionar
Estas condiciones son para las agencias inmobiliarias que usan la API de controldealquiler.com, que es la forma de que vuestro programa trabaje con vuestra cuenta de agencia sin pasar por el panel, y el SDK oficial. Las ofrece Trajano Labs, S.L. (NIF B05655378). Son el Anexo 1 de las Condiciones para agencias, en controldealquiler.com/condiciones/agencias. En lo que toca a la API, si hay contradicción, mandan estas. El encargo de tratamiento es el Anexo 2 de las Condiciones para agencias.
1. Quién puede usarla
Una cuenta de agencia con el acceso por API activado. Contratas como empresa o profesional, no como consumidor. Lo que haces por la API tiene el mismo efecto que hacerlo en el panel, con las mismas reglas, en lo que la API permite hacer.
2. Tus API keys
Las creas en tu perfil, en «Acceso por API». Cada key caduca a los 3, 6 o 12 meses, según elijas, y solo la ves una vez: guardamos una huella que no permite recuperarla. Si crees que alguien ha visto una key, revócala en tu perfil. Deja de valer en ese momento, también para los lotes que tengas en marcha. Lo que se hizo con ella antes no se deshace solo. Hasta que la revoques, respondes ante nosotros de lo que se haga con una key tuya, salvo que se deba a un incumplimiento nuestro de estas condiciones o de la ley, o a un fallo de seguridad de nuestros sistemas. Si la usa alguien sin tu permiso, es además un fallo de seguridad que gestionas tú como responsable de los datos.
3. Documentación para desarrolladores
La documentación para desarrolladores explica el funcionamiento técnico de la API. Es informativa y podemos actualizarla.
4. Los documentos se leen en tu sistema
El SDK lee los contratos y los justificantes en tu sistema con nuestro lector, el mismo que el panel, sin inteligencia artificial. A nosotros llegan el fichero, cifrado para tu cliente, y lo leído (importes, fechas y conceptos), que se guarda legible, como en cualquier cuenta. Nuestro servidor no puede comprobar que esa lectura la hizo nuestro lector: tiene que salir de él sin cambios. Escribirla o alterarla a mano incumple estas condiciones.
Si en algún momento tenemos que leer en nuestro servidor, te lo diremos antes. Entonces el fichero viaja sin el cifrado de extremo a extremo, protegido solo en el camino, y lo leemos en memoria, sin guardar el fichero.
5. Preaceptado tras comprobarlo
Lo que das de alta a partir de nuestro lector entra en la cuenta de tu cliente «por comprobar», y mientras tanto no suma en sus casillas. Cuando alguien entra en esa cuenta, su navegador vuelve a leer el documento con el mismo lector. La fila queda preaceptada si los datos coinciden con los que subiste y se cumplen las demás comprobaciones del alta: por ejemplo, que tu cliente tenga activado ese año, que esa renta no esté ya registrada y, en los justificantes, que la dirección del documento sea la de la vivienda. Una fila preaceptada suma en sus casillas, lleva el sello «De tu agencia», y tu cliente puede revisarla, editarla o rechazarla. Si no se cumple todo, o si no se puede volver a leer, queda por revisar y no suma. Esa comprobación solo prueba que nuestro lector, leyendo el mismo documento en la cuenta de tu cliente, saca los mismos datos que subiste. No prueba que la lectura sea correcta, ni que el documento sea auténtico o de esa vivienda: de eso respondes tú. Y solo prueba algo frente a ti si la cuenta la activó tu cliente. Y nos mantienes indemnes de las reclamaciones de tus clientes por esos datos.
6. El enlace de activación lo entregas tú
Por la API, el enlace para que tu cliente active su cuenta lo compone el SDK en tu sistema, con un secreto que nosotros no tenemos. Hasta que tu cliente lo usa, el enlace abre su cuenta a quien lo tenga, durante siete días. Te comprometes a:
- mandárselo solo a tu cliente, por un canal privado;
- no usarlo tú ni dárselo a nadie más;
- no guardarlo más tiempo del que necesitas para entregarlo, ni en más sistemas que el canal por el que se lo mandas;
- si crees que lo ha visto alguien más, crear otro: el anterior deja de valer en ese momento.
Si activas tú la cuenta de tu cliente, la comprobación del punto 5 se hace desde tu sesión y no prueba nada frente a ti. Eso incumple estas condiciones, y frente a nosotros respondes tú de lo que entre preaceptado así.
7. La clave de integración
Para que tu programa abra lo que te entregamos sellado, generas en tu sistema un par de claves de integración y pegas la pública en tus ajustes. Tu navegador, con tu caja fuerte desbloqueada, sella tu clave privada de agencia para esa pública; nosotros guardamos el sobre cerrado y no podemos abrirlo. Es una custodia por máquina: la clave vive en tu sistema, sin una persona que teclee una contraseña.
Quien tenga la clave privada de integración y ese sobre puede abrir todo lo que controldealquiler.com entrega sellado a tu agencia: los documentos y datos de las altas que preparas, también contratos y documentos de identidad de tus clientes y de sus inquilinos antes de que tus clientes activen su cuenta, y las copias que se guardan para ti. No abre lo que tu cliente añade en su cuenta. Te comprometes a:
- guardar la clave privada de integración en un gestor de secretos, en una variable de entorno de la infraestructura en que se ejecuta tu integración o en un fichero de un servidor bajo tu control y, en todos los casos, con el acceso limitado a las personas y los procesos que la necesitan;
- no copiarla a repositorios de código ni a sistemas distintos del gestor de secretos o de la infraestructura en que se ejecuta tu integración;
- si crees que se ha expuesto, revocar la API key y escribirnos enseguida a help@controldealquiler.com.
Revocar corta el acceso por la API, pero no deshace lo que ya se haya descargado y abierto.
8. Créditos
Lo que hagas por la API gasta créditos igual que en el panel. Cambiar la renovación, que decide si se gastan créditos al renovar, solo lo puede hacer una key que tenga ese permiso, como explica la documentación para desarrolladores. Lo que se gaste con una key tuya hasta que la revoques es gasto tuyo, en los mismos términos del punto 2. Las devoluciones son las de las condiciones de compra de créditos que se apliquen a tu cuenta.
9. Uso correcto y límites
La API tiene límites de uso (peticiones y lecturas al día), que publicamos en controldealquiler.com/desarrolladores. Si se supera un límite, la API responde que esperes.
No puedes probar la seguridad del servicio sin nuestro permiso por escrito, ni intentar acceder a datos que no son tuyos, ni revender el acceso, ni usar la API para algo distinto de llevar a tus clientes. Podemos suspender una key, o el acceso por API de tu cuenta, si se incumplen estas condiciones o si hace falta para proteger el servicio o a tus clientes. Te lo diremos, y si es posible, antes.
10. Cambios
Los cambios de este Anexo siguen la cláusula 11 de las Condiciones para agencias.
11. Responsabilidad y fin
La responsabilidad es la de la cláusula 8 de las Condiciones para agencias. Puedes dejar de usar la API cuando quieras, revocando tus keys. Al pedir la baja como agencia, tus keys dejan de valer y se aplica la cláusula 10 de las Condiciones para agencias.
12. Cómo se contrata
Aceptas estas condiciones, como Anexo 1, al aceptar las Condiciones para agencias al entrar en el panel. Después creas tus keys en tu perfil, en «Acceso por API». Guardamos la versión que aceptaste, con su fecha y el idioma. Al crear la key te la confirmamos en pantalla, con un justificante que puedes descargar. Las condiciones están siempre en controldealquiler.com/condiciones-api, donde puedes guardarlas o imprimirlas, y cada versión en su enlace. El contrato se formaliza en castellano.
13. Entorno de pruebas
Podemos darte acceso a un entorno de pruebas gratuito, tal como está, sin compromiso de disponibilidad ni de plazos. Podemos cambiarlo, vaciarlo o retirarlo cuando queramos.
Puedes usar en el entorno de pruebas datos y documentos reales de tus clientes y de las personas que aparecen en ellos solo si tu agencia puede usarlos para probar tu integración —porque esa prueba es compatible con el fin para el que los tienes, o porque tienes otra base para ello— y has informado a esas personas como pide el punto 6 del Anexo 2 de las Condiciones para agencias y, si probar es un fin distinto, también de ese fin. Usa solo los que necesites para la prueba; si te bastan datos ficticios, mejor. Esos datos los tratamos por cuenta de tu agencia, con el encargo de tratamiento del Anexo 2 de las Condiciones para agencias, que también se aplica aquí, con estas diferencias: la única finalidad es probar tu integración; en el entorno de pruebas también las cuentas que se activan son de pruebas, las tratamos por cuenta de tu agencia y se borran con el cliente; los plazos son los de esta sección y no los del punto 4 del Anexo 2 de las Condiciones para agencias; y al aceptar esta sección nos indicas que borremos esos datos en esos plazos, y cuando vaciemos o retiremos el entorno, sin devolvértelos. No guardes allí nada que necesites conservar. Que el entorno sea gratuito y sin compromiso de disponibilidad no rebaja las medidas de seguridad del punto 5 del Anexo 2 de las Condiciones para agencias. Usa en pruebas una contraseña de cifrado y un par de claves de integración distintos de los de producción.
En el entorno de pruebas puedes activar tú las cuentas de tus clientes de pruebas. Para ellas no se aplican la última frase del punto 6 de estas condiciones ni, en el punto 6 del Anexo 2 de las Condiciones para agencias, el compromiso de no activar tú su cuenta.
El entorno de pruebas no envía ningún correo a nadie, ni a ti ni a tus clientes. Lo que el encargo de tratamiento nos obliga a comunicarte, como un fallo de seguridad (punto 8 del Anexo de las Condiciones del Servicio) o un cambio de proveedores (letra (a) del Anexo 2 de las Condiciones para agencias), te lo escribiremos desde help@controldealquiler.com a la dirección de tu cuenta de pruebas. Los demás avisos sobre este entorno, como una parada o un vaciado, los publicaremos en la documentación para desarrolladores.
Borramos los clientes que das de alta en el entorno de pruebas, y todo lo suyo, a los 30 días de darlos de alta, también si usas datos reales o si han activado su cuenta; y la cuenta de pruebas tras 90 días sin iniciar sesión en ella ni usar ninguna de sus keys. Borramos sin aviso previo. Lo borrado puede seguir hasta 7 días más en las copias de seguridad del proveedor. Solo las usaríamos para recuperar el entorno entero tras una avería, y antes de volver a abrirlo borraríamos otra vez lo que ya había caducado o habíamos vaciado. Lo que hay en el entorno de pruebas, cifras incluidas, no tiene validez fiscal ni sirve para ninguna declaración. Las keys, los créditos y los datos del entorno de pruebas no valen en producción, ni al revés.
14. El SDK y su continuidad
Te damos el SDK mientras ofrezcamos la API. Si lo retiramos, te avisaremos con al menos 90 días. El soporte se presta en help@controldealquiler.com, sin plazo garantizado.
