> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Resumen de la API

> Crea y despliega aplicaciones web de forma programática con la API de Macaly

La API de Macaly permite que aplicaciones externas creen chats, creen aplicaciones web con IA y las desplieguen en producción de forma programática.

<Callout icon="user">
  Disponible solo en el [**plan Agencias**](/docs/es/welcome/pricing)
</Callout>

## URL base

```
https://www.macaly.com
```

## Inicio rápido

1. **Obtén una clave API** - Consulta [Autenticación](/docs/es/api/authentication)
2. **Crea un chat** - Envía un prompt para empezar a crear tu app
3. **Sigue el progreso** - Espera a que la IA termine
4. **Despliega** - Publica tu app en producción

## Endpoints disponibles

| Método | Endpoint | Descripción |
| - | - | - |
| POST | [`/api/chat`](/docs/es/api/create-chat) | Crea un chat nuevo y empieza a trabajar |
| POST | [`/api/chat/{chatId}/publish`](/docs/es/api/publish-message) | Envía un mensaje a un chat existente |
| POST | [`/api/client-app/assets/upload`](/docs/es/api/upload-asset) | Sube un archivo y obtén una URL de CDN permanente |
| GET | [`/api/chat/{chatId}/status`](/docs/es/api/get-status) | Comprueba el estado del proceso |
| GET | [`/api/chat/{chatId}/subscribe`](/docs/es/api/subscribe-stream) | Suscríbete al stream en tiempo real |
| POST | [`/api/chat/{chatId}/deploy`](/docs/es/api/deploy) | Despliega el chat en producción |
| GET | [`/api/chat/{chatId}/deployment`](/docs/es/api/get-deployment) | Consulta el estado del despliegue |

## Límites de solicitudes y créditos

* Las solicitudes a la API consumen créditos del saldo de tu equipo
* Cada chat creado cuesta lo mismo que usar la interfaz web
* Los intentos fallidos con la clave API están sujetos a un límite de solicitudes (5 por minuto por dirección IP)
* Consulta tu uso en **Ajustes → Uso y límites**

## Gestión de errores

Todos los errores devuelven un JSON con un campo `error`:

```json theme={null}
{
  "error": "Error message here"
}
```

### Códigos de estado HTTP

| Código | Descripción |
| - | - |
| 400 | Bad Request: cuerpo de la solicitud no válido |
| 401 | Unauthorized: clave API no válida o ausente |
| 402 | Payment Required: créditos insuficientes |
| 403 | Forbidden: sin permiso o equipo incorrecto |
| 404 | Not Found: recurso no encontrado |
| 422 | Unprocessable Entity: error de validación |
| 429 | Too Many Requests: límite de solicitudes alcanzado |
| 500 | Internal Server Error: error del servidor |
| 503 | Service Unavailable: el servidor está ocupado, inténtalo de nuevo más tarde |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.