> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.modulards.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Cómo usar la API pública de Modular DS

La API pública de Modular DS te permite conectar tu cuenta con otras herramientas y gestionar tus webs mediante código, sin pasar por el panel.

Su uso más habitual es integrar la información de Modular DS en tu propio panel, como el de tu hosting o el de tu agencia, para gestionar las webs desde ahí o mostrar esos datos a tus clientes.

También puedes crear integraciones con otras herramientas, conectar Modular DS con plataformas de automatización como Zapier, Make o n8n, o programar tus propios scripts.

Aquí tienes lo esencial para empezar: cómo crear tu clave y qué puedes hacer con ella. Y si ya te manejas, puedes ir directo a [la documentación de la API con todos los endpoints y ejemplos](https://api.docs.modulards.com/introduction).

## Crear tu clave de API

Para usar la API necesitas una clave (**tu token de acceso**), que identifica cada petición con tu cuenta.

La creas desde tu perfil, en la [pestaña "API"](https://app.modulards.com/profile/api-tokens), con el botón "Crear clave".

Al generarla, defines dos cosas:

* **Los permisos:** "Solo lectura", que únicamente consulta datos, o "Lectura y escritura", que además permite crear, modificar y lanzar acciones.
* **La caducidad:** opcional, por si quieres que la clave deje de funcionar en una fecha concreta.

Por seguridad, **la clave se muestra una sola vez**, en el momento de crearla. Cópiala y guárdala en un lugar seguro, porque después ya no podrás volver a verla.

Si la pierdes, tendrás que crear una nueva y actualizarla allí donde la estuvieras usando.

En el listado de la pestaña "API" ves todas tus claves con sus permisos y su fecha de creación. Desde ahí puedes cambiar los permisos de una clave o revocar la que ya no uses, en su menú de opciones.

![](https://storage.crisp.chat/users/helpdesk/website/-/a/a/5/5/aa55333f4a914000/claves-api-modular-ds_dwn4e6.png)

## Qué puedes hacer con la API

A través de la API puedes consultar la mayor parte de la información que encuentras en Modular DS y realizar acciones sin entrar en el panel. Por ejemplo:

* Webs, equipos y etiquetas: listarlas, crearlas, editarlas y conectarlas.
* Actualizaciones: inventario de plugins, temas y core, e instalación o actualización de componentes.
* Backups: crear y gestionar tus copias de seguridad.
* Uptime Monitor y certificados SSL.
* Análisis de malware y enlaces rotos.
* Vulnerabilidades y estado de salud de cada web.
* Tareas, clientes, contactos y configuraciones de notificaciones.

## Cómo hacer tus peticiones

Todas las peticiones se autentican con tu clave de API y comparten la misma URL base: `https://api.modulards.com/api/public/v1`.

La API sigue el estándar JSON:API, así que las URLs de recurso son predecibles y todas las respuestas tienen el mismo formato.

En la [documentación de la API](https://api.docs.modulards.com/introduction) tienes el detalle de la autenticación, la paginación, los filtros y los errores.

## Kit de ejemplo

Si quieres ver la API funcionando antes de programar nada, tienes un [kit de ejemplo](https://api.docs.modulards.com/example-kit): una aplicación de código abierto que puedes abrir en [examplekit.modulards.ai](https://examplekit.modulards.ai/) y usar con tu propia clave.

Cada pantalla del kit se apoya en una llamada real a la API, así que sirve tanto para explorar los datos como para ver cómo se construye cada petición.

Para probarlo sin riesgo, usa una clave de "Solo lectura", que no modifica nada. El código está publicado en [GitHub](https://github.com/modulards/api-example-kit) por si quieres partir de él para tu propio proyecto.

## ¿API o MCP?

La API pública y el MCP son dos formas de trabajar con Modular DS sin entrar en el panel, pensadas para usos distintos:

* La API pública es para tus propias integraciones, automatizaciones y scripts.
* El MCP es para gestionar tus webs desde un asistente de IA como Claude o ChatGPT, usando lenguaje natural.

Si lo que buscas es esto último, sigue la guía de [cómo conectar el MCP de Modular DS a tu asistente de IA](https://help.modulards.com/es/article/como-conectar-el-mcp-de-modular-ds-a-tu-asistente-de-ia-14v7tbf/).

## Artículos relacionados

* [El MCP de Modular DS: qué es y qué puedes hacer con él](https://help.modulards.com/es/article/el-mcp-de-modular-ds-que-es-y-que-puedes-hacer-con-el-1uwd3it/)
* [Cómo conectar el MCP de Modular DS a tu asistente de IA](https://help.modulards.com/es/article/como-conectar-el-mcp-de-modular-ds-a-tu-asistente-de-ia-14v7tbf/)
* [Ejemplos de prompts para usar el MCP de Modular DS](https://help.modulards.com/es/article/ejemplos-de-prompts-para-usar-el-mcp-de-modular-ds-1stzo0q/)

¿Necesitas ayuda con algo más? Escríbenos a [help@modulards.com](mailto:help@modulards.com) o a través del chat de soporte y estaremos encantados de ayudarte.