El Centro para desarrolladores es donde conectas Exayard con tu propio código y tus herramientas. Ábrelo desde Ajustes y luego Desarrollador. Desde aquí creas claves de API, registras endpoints de webhook y revisas un registro en vivo de cada solicitud a la API. Solo los administradores de la organización pueden acceder a esta página.
Claves de API
Una clave de API autentica las solicitudes a la API de Exayard. Las claves pertenecen a tu organización, así que se selecciona automáticamente la cuenta correcta y no hay ningún ID de organización que pasar.
Abre la pestaña Claves de API en la tarjeta Credenciales y haz clic en el botón +. Asigna a la clave un Nombre y luego elige sus Ámbitos. Selecciona Todos para conceder todos los ámbitos, o Específicos para elegir permisos individuales. Los ámbitos siguen una división de lectura y escritura por recurso, como read:projects y write:estimates. El ámbito admin:org es una concesión de acceso total. Elige los ámbitos mínimos que necesite tu integración.
Exayard muestra la clave completa una sola vez, justo después de crearla. Cópiala en ese momento, porque no se vuelve a mostrar. Después, cada clave aparece con su nombre, una vista previa enmascarada como ak_••••1234 y la fecha en que se usó por última vez.
Usa el icono del lápiz para cambiar el nombre de una clave o sus ámbitos. Usa el icono de la papelera para Revocarla. La revocación es permanente y cualquier integración que use esa clave deja de funcionar de inmediato.
La misma clave autentica las integraciones sin código. Consulta Conectar Exayard con Zapier, Conectar Exayard con Make y Conectar Exayard con n8n. Para el acceso de agentes y editores de IA, consulta Conectar con Claude y otras herramientas de IA.
Webhooks
Un webhook indica a Exayard que notifique a tu servidor cuando ocurre algo. Abre la pestaña Webhooks y haz clic en + para añadir un endpoint. Introduce la URL que debe recibir las entregas y una Descripción opcional.
Elige a qué Eventos suscribirte. Selecciona Todos para recibir cada evento, o Específicos para elegir de la lista:
Evento | Se dispara cuando |
| Se crea un proyecto |
| Se modifica un proyecto |
| Se archiva un proyecto |
| Comienza una evaluación de medición |
| Finaliza una evaluación |
| Se aprueba una evaluación |
| Se cancela una evaluación |
| Se genera una estimación |
| Se genera una oferta |
| Termina de procesarse un archivo subido |
Cuando creas un endpoint, Exayard muestra un secreto de firma una sola vez. Cópialo en ese momento, porque no se vuelve a mostrar.
Proteger las entregas de webhook
Cada entrega lleva un encabezado Exayard-Signature con el formato t=<unix>,v1=<digest>. Exayard construye la firma uniendo la marca de tiempo y el cuerpo de la solicitud, y luego firmándolos con HMAC-SHA256 usando el secreto de tu endpoint.
Para verificar una entrega, vuelve a calcular la firma con tu secreto, confirma que la marca de tiempo está dentro de los cinco minutos a partir de ahora y compara los resúmenes. Las entregas fallidas se reintentan con retroceso exponencial durante aproximadamente tres días.
Para editar un endpoint, haz clic en el icono del lápiz. Puedes cambiar la URL, la descripción y los eventos, y establecer su Estado en Activo o En pausa. Los endpoints en pausa dejan de recibir entregas. El mismo cuadro de diálogo tiene un botón Rotar secreto. La rotación emite un secreto nuevo y el antiguo deja de funcionar de inmediato, así que actualiza tu servidor antes de rotar. El icono de la papelera elimina un endpoint y pone fin a todas las entregas hacia él.
Inicio rápido
La tarjeta Inicio rápido contiene un prompt listo para usar con un editor de IA como Claude o Cursor. Haz clic en Copiar prompt y pégalo en tu editor. El prompt incluye la URL base de la API, el formato de autenticación, el vocabulario de ámbitos y el esquema de firma de webhooks, para que la IA pueda generar el andamiaje de una integración funcional y pedirte los detalles que necesite.
Documentación
La tarjeta Documentación enlaza con la documentación completa para desarrolladores y con la especificación OpenAPI, que describe cada ruta y esquema. Conectar MCP abre la configuración para conectar agentes de IA directamente con Exayard.
Registros
La sección Registros anota tus solicitudes de API más recientes, tanto de la API REST como de MCP. Cada fila muestra el método, la ruta, el estado de respuesta y la latencia. Selecciona una fila para ver todo su detalle, incluido el ID de solicitud y los cuerpos de la solicitud y la respuesta. Usa los registros para confirmar que una llamada funcionó o para depurar una integración que falla.
