API-Überblick - Macaly Documentation

Die Macaly-API ermöglicht es externen Anwendungen, Chats zu erstellen, Webanwendungen mit KI zu erstellen und sie programmatisch in der Produktion zu deployen.

Nur im Agentur-Plan verfügbar

Basis-URL

https://www.macaly.com

Schnellstart

Hol dir einen API-Schlüssel - Siehe Authentifizierung
Erstelle einen Chat - Sende einen Prompt, um mit der Erstellung zu beginnen
Verfolge den Fortschritt - Warte, bis die KI fertig ist
Deploye - Veröffentliche deine App in der Produktion

Verfügbare Endpoints

Methode	Endpoint	Beschreibung
POST	`/api/chat`	Einen neuen Chat erstellen und mit der Erstellung beginnen
POST	`/api/chat/{chatId}/publish`	Eine Nachricht an einen bestehenden Chat senden
POST	`/api/client-app/assets/upload`	Eine Datei hochladen und eine permanente CDN-URL erhalten
GET	`/api/chat/{chatId}/status`	Den Verarbeitungsstatus abfragen
GET	`/api/chat/{chatId}/subscribe`	Den Echtzeit-Stream abonnieren
POST	`/api/chat/{chatId}/deploy`	Den Chat in der Produktion deployen
GET	`/api/chat/{chatId}/deployment`	Den Deployment-Status abrufen

Anfragelimits und Credits

API-Anfragen verbrauchen Credits vom Guthaben deines Teams
Jede Chat-Erstellung kostet genauso viel wie die Nutzung der Weboberfläche
Fehlgeschlagene Versuche mit dem API-Schlüssel unterliegen einem Anfragelimit (5 pro Minute pro IP-Adresse)
Überprüfe deine Nutzung unter Einstellungen → Nutzung & Limits

Fehlerbehandlung

Alle Fehler geben JSON mit einem error-Feld zurück:

{
  "error": "Error message here"
}

HTTP-Statuscodes

Status	Beschreibung
400	Bad Request: Ungültiger Anfrage-Body
401	Unauthorized: Ungültiger oder fehlender API-Schlüssel
402	Payment Required: Nicht genügend Credits
403	Forbidden: Keine Berechtigung oder falsches Team
404	Not Found: Ressource nicht gefunden
422	Unprocessable Entity: Validierungsfehler
429	Too Many Requests: Anfragelimit erreicht
500	Internal Server Error: Serverfehler
503	Service Unavailable: Server ist ausgelastet, versuche es später erneut

​Basis-URL

​Schnellstart

​Verfügbare Endpoints

​Anfragelimits und Credits

​Fehlerbehandlung

​HTTP-Statuscodes

Basis-URL

Schnellstart

Verfügbare Endpoints

Anfragelimits und Credits

Fehlerbehandlung

HTTP-Statuscodes