> For the complete documentation index, see [llms.txt](https://docs.yoplanning.support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yoplanning.support/es/developpeur/api-agent-yoplanning.md). # API del agente de Yoplanning Yoplanning ofrece una **API de agente**, que le permite controlar Yoplanning mediante programación —o a través de un asistente de IA— exactamente como si estuviera utilizando la interfaz web. La referencia técnica completa (todos los puntos finales, todos los campos) está disponible en Swagger: {% embed url="" %} Referencia completa de la API del agente de Yoplanning {% endembed %} Este artículo no sustituye a esta referencia técnica: explica el principio general, para qué se utiliza esta API y, sobre todo, las precauciones que hay que tomar antes de conectarla a cualquier cosa. ### Metodología La API del agente sigue unos principios sencillos, pero conviene tenerlos en cuenta antes de usarla: * **Este es un puente directo al código interno de Yoplanning**, el mismo código que utiliza la interfaz web. Escribir a través de la API tiene exactamente el mismo comportamiento, validaciones y efectos secundarios que una acción manual dentro de Yoplanning. No hay lógica oculta: lo que permite la interfaz, lo permite la API; lo que rechaza la interfaz, también lo rechaza la API, con el mismo error. * **Todo está restringido al ámbito del equipo.** Casi todas las direcciones comienzan con el ID de tu equipo (`/teams/{teamId}/…`), y un token solo da acceso al equipo para el que fue creado. * **Regla de ida y vuelta para cualquier modificación:** Se recupera el objeto existente, se modifican los campos deseados y, a continuación, se vuelve a enviar el objeto completo. Una actualización no es una solución parcial: cualquier campo que falte en el envío se restablece. Esta es una fuente común de errores si no se prevé. * **Autenticación mediante token**, específica para un usuario y un equipo, transmitida en cada solicitud a través del encabezado `Authorization`. ### ¿Para qué sirve? La API de agente te permite crear, configurar, modificar o eliminar casi cualquier cosa que gestione Yoplanning: clientes, productos, sesiones, pedidos, pagos, personal, códigos promocionales, motor de reservas, revendedores, etc., con los mismos derechos que la persona a la que pertenece el token. En la práctica, se utiliza para conectar Yoplanning a un sistema externo (sitio web, herramienta interna, otro software empresarial) o a un asistente de IA al que queremos delegar tareas de configuración o gestión en lenguaje natural, en lugar de hacerlo todo manualmente en la interfaz. ### Riesgos que debe tener en cuenta antes de conectar una herramienta a esta API. Esta **no** es una API de solo lectura: proporciona un acceso tan potente como el de una cuenta de usuario de Yoplanning con sesión iniciada. Antes de conectarla a una herramienta, script o asistente de IA, tenga en cuenta estos puntos: \*\*El token es información estrictamente confidencial, al igual que una contraseña.\*\* Cualquier persona o programa en su posesión puede actuar sobre su equipo exactamente como usted puede: crear, modificar, eliminar. Nunca lo pegues en un repositorio de código (ni siquiera en uno privado), un mensaje sin cifrar, un correo electrónico, una captura de pantalla o una herramienta en la que no confíes plenamente. Si se filtra, considéralo comprometido: genera uno nuevo inmediatamente desde tus preferencias avanzadas o contacta con si no sabes cómo proceder. * **Los efectos secundarios son reales.** Un script puede enviar un correo electrónico de confirmación, registrar un pago, enviar una invitación o eliminar datos de forma real, aunque sea una sola vez, tal como lo haría la interfaz. Por lo tanto, un script o agente mal diseñado puede desencadenar acciones reales por parte de sus clientes o equipo, y no solo modificar datos internamente. * **Una actualización reemplaza el objeto completo.** Si la herramienta a la que se conecta no vuelve a leer el objeto antes de devolverlo modificado, puede eliminar campos involuntariamente en lugar de dejarlos como están. * **El token conlleva los derechos de la persona que lo creó.** Si conectas un asistente de IA a esta API, podrá realizar —y deshacer— todas las acciones que esa persona puede realizar en este equipo. Define claramente lo que le pides que haga, especialmente para cualquier acción irreversible (eliminación, envío de correos electrónicos o mensajes SMS, procesamiento de pagos), y prioriza un token creado específicamente para este propósito en lugar de tu token personal principal, si la herramienta lo permite. ### Para ir más allá Para una integración de IA más sencilla y de solo lectura, limitada por tus propios permisos, consulta también el artículo [Conexión a Yoplanning a través de MCP](/es/developpeur/se-connecter-a-yoplanning-via-mcp.md). Para obtener información completa sobre los recursos y campos de la API del agente, la referencia actual sigue siendo [Swagger](https://yoplanning.pro/api/agent/v1/swagger/). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.yoplanning.support/es/developpeur/api-agent-yoplanning.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.