> ## 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-översikt

> Bygg och publicera webbapplikationer programmatiskt med Macaly API

Med Macaly API kan externa applikationer skapa chattar, bygga webbapplikationer med AI och publicera dem i produktion programmatiskt.

<Callout icon="user">
  Finns bara i [**abonnemanget Byrå**](/docs/sv/welcome/pricing)
</Callout>

## Bas-URL

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

## Snabbstart

1. **Skaffa en API-nyckel** - Se [Autentisering](/docs/sv/api/authentication)
2. **Skapa en chatt** - Skicka en prompt för att börja bygga
3. **Vänta tills den är klar** - Kontrollera statusen tills AI:n är färdig
4. **Publicera** - Lansera din app i produktion

## Tillgängliga endpoints

| Metod | Endpoint | Beskrivning |
| - | - | - |
| POST | [`/api/chat`](/docs/sv/api/create-chat) | Skapa en ny chatt och börja bygga |
| POST | [`/api/chat/{chatId}/publish`](/docs/sv/api/publish-message) | Skicka ett meddelande till en befintlig chatt |
| POST | [`/api/client-app/assets/upload`](/docs/sv/api/upload-asset) | Ladda upp en fil och få en permanent CDN-URL |
| GET | [`/api/chat/{chatId}/status`](/docs/sv/api/get-status) | Kontrollera arbetsflödets status |
| GET | [`/api/chat/{chatId}/subscribe`](/docs/sv/api/subscribe-stream) | Prenumerera på strömmen i realtid |
| POST | [`/api/chat/{chatId}/deploy`](/docs/sv/api/deploy) | Publicera chatten i produktion |
| GET | [`/api/chat/{chatId}/deployment`](/docs/sv/api/get-deployment) | Hämta publiceringsstatus |

## Begränsningar och krediter

* API-anrop drar krediter från ditt teams saldo
* Att skapa en chatt kostar lika mycket som i webbgränssnittet
* Misslyckade försök med API-nyckel är begränsade (5 per minut och IP-adress)
* Följ din användning under **Inställningar → Användning och begränsningar**

## Felhantering

Alla fel returneras som JSON med ett `error`-fält:

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

### HTTP-statuskoder

| Status | Beskrivning |
| - | - |
| 400 | Bad Request - Ogiltig request body |
| 401 | Unauthorized - Ogiltig eller saknad API-nyckel |
| 402 | Payment Required - Otillräckligt med krediter |
| 403 | Forbidden - Behörighet saknas eller fel team |
| 404 | Not Found - Resursen hittades inte |
| 422 | Unprocessable Entity - Valideringsfel |
| 429 | Too Many Requests - För många anrop |
| 500 | Internal Server Error - Fel på serversidan |
| 503 | Service Unavailable - Servern är upptagen, försök igen senare |


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