# Introducción

La API de Atomicat es una API HTTPS de la cuenta dueña de la clave. Sirve para crear y publicar páginas, administrar sitios, embudos, videos y productos, leer leads y recibir webhooks.

URL base de producción:

```text
https://automation.atomicat-api.com/api/automation/v1
```

```bash
curl "https://automation.atomicat-api.com/api/automation/v1/me" \
  -H "Authorization: Bearer $ATOMICAT_API_KEY"
```

## Qué puedes hacer

| Área | Qué cubre la API |
| --- | --- |
| Proyectos | Listar, crear, actualizar y eliminar un proyecto que ya no usa nada |
| Sitios | Listar, crear y leer. Esta API no elimina sitios |
| Páginas | Crear, duplicar, editar, publicar y eliminar |
| Constructor | Leer el árbol de la página y actualizar un nodo |
| Quizzes | Listar registros y crear páginas de quiz |
| Embudos | Listar, crear, actualizar y leer. Esta API no elimina embudos |
| Videos | Listar y actualizar el reproductor. Las cargas y las eliminaciones siguen en la app |
| Productos | Listar, crear, actualizar y eliminar |
| Leads | Buscar leads de formularios y quizzes |
| Analítica | Conteos de la cuenta, no un informe de tráfico |
| Webhooks | Suscribirse a eventos de leads, páginas, productos, embudos, sitios y proyectos |

Las listas y las búsquedas devuelven un arreglo JSON. Un registro individual devuelve un objeto.

## De dónde sale la clave

Crea una clave en la app de Atomicat, en **Ajustes → Claves de API**. La clave completa se muestra una sola vez. La API guarda un hash, un prefijo corto, los alcances, una caducidad opcional y una lista opcional de IPs.

## Cómo se mantienen estos documentos

Las páginas de referencia se generan desde `apis/openapi.json` cuando se construye este sitio. Cambiar ese archivo no cambia el sitio publicado hasta que se vuelve a construir y publicar.

El mismo documento en inglés lo sirve la API:

```text
GET https://automation.atomicat-api.com/api/automation/v1/openapi.json
```

El inglés es el idioma predeterminado. El español está en `/es` y el portugués en `/pt`. Las rutas, los nombres de campos y los alcances siguen en inglés. El tema claro y el tema oscuro están en el encabezado.

## Para agentes y rastreadores

Las páginas son HTML estático y están en [sitemap.xml](https://docs.atomicat.ai/sitemap.xml). Cada guía también está en Markdown en la misma ruta con el sufijo `.md`, por ejemplo [/es/introduction.md](https://docs.atomicat.ai/es/introduction.md). [/llms.txt](https://docs.atomicat.ai/llms.txt) es el índice y [/llms-full.txt](https://docs.atomicat.ai/llms-full.txt) es el texto completo de las guías. El documento OpenAPI está en [/openapi.json](https://docs.atomicat.ai/openapi.json).