Resumen de la API - Macaly Documentation

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.

Disponible solo en el plan Agencias

URL base

https://www.macaly.com

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

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

Todos los errores devuelven un JSON con un campo error:

{
  "error": "Error message here"
}

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