> ## 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.

# API-Überblick

> Erstelle und deploye Webanwendungen programmatisch mit der Macaly-API

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

<Callout icon="user">
  Nur im [**Agentur-Plan**](/docs/de/welcome/pricing) verfügbar
</Callout>

## Basis-URL

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

## Schnellstart

1. **Hol dir einen API-Schlüssel** - Siehe [Authentifizierung](/docs/de/api/authentication)
2. **Erstelle einen Chat** - Sende einen Prompt, um mit der Erstellung zu beginnen
3. **Verfolge den Fortschritt** - Warte, bis die KI fertig ist
4. **Deploye** - Veröffentliche deine App in der Produktion

## Verfügbare Endpoints

| Methode | Endpoint | Beschreibung |
| - | - | - |
| POST | [`/api/chat`](/docs/de/api/create-chat) | Einen neuen Chat erstellen und mit der Erstellung beginnen |
| POST | [`/api/chat/{chatId}/publish`](/docs/de/api/publish-message) | Eine Nachricht an einen bestehenden Chat senden |
| POST | [`/api/client-app/assets/upload`](/docs/de/api/upload-asset) | Eine Datei hochladen und eine permanente CDN-URL erhalten |
| GET | [`/api/chat/{chatId}/status`](/docs/de/api/get-status) | Den Verarbeitungsstatus abfragen |
| GET | [`/api/chat/{chatId}/subscribe`](/docs/de/api/subscribe-stream) | Den Echtzeit-Stream abonnieren |
| POST | [`/api/chat/{chatId}/deploy`](/docs/de/api/deploy) | Den Chat in der Produktion deployen |
| GET | [`/api/chat/{chatId}/deployment`](/docs/de/api/get-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:

```json theme={null}
{
  "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 |


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