> ## 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 áttekintés

> Építs és tégy közzé webalkalmazásokat programozottan a Macaly API-val

A Macaly API lehetővé teszi, hogy külső alkalmazások beszélgetéseket hozzanak létre, AI segítségével webalkalmazásokat építsenek, és programozottan közzétegyék őket élesben.

<Callout icon="user">
  Csak az [**Ügynökségi csomagban**](/docs/hu/welcome/pricing) érhető el
</Callout>

## Alap URL

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

## Első lépések

1. **Szerezz API-kulcsot** - Lásd a [Hitelesítés](/docs/hu/api/authentication) oldalt
2. **Hozz létre egy beszélgetést** - Küldj egy promptot, és indítsd el az építést
3. **Kérdezd le az állapotot** - Várd meg, amíg az AI végez
4. **Tedd közzé** - Publikáld az alkalmazást élesben

## Elérhető végpontok

| Metódus | Végpont | Leírás |
| - | - | - |
| POST | [`/api/chat`](/docs/hu/api/create-chat) | Új beszélgetés létrehozása és az építés elindítása |
| POST | [`/api/chat/{chatId}/publish`](/docs/hu/api/publish-message) | Üzenet küldése egy meglévő beszélgetésbe |
| POST | [`/api/client-app/assets/upload`](/docs/hu/api/upload-asset) | Fájl feltöltése és állandó CDN URL lekérése |
| GET | [`/api/chat/{chatId}/status`](/docs/hu/api/get-status) | A munkafolyamat állapotának lekérdezése |
| GET | [`/api/chat/{chatId}/subscribe`](/docs/hu/api/subscribe-stream) | Feliratkozás a valós idejű adatfolyamra |
| POST | [`/api/chat/{chatId}/deploy`](/docs/hu/api/deploy) | A beszélgetés közzététele élesben |
| GET | [`/api/chat/{chatId}/deployment`](/docs/hu/api/get-deployment) | A közzététel állapotának lekérése |

## Korlátok és kreditek

* Az API-kérések a munkaterületed egyenlegéből használnak krediteket
* Egy beszélgetés létrehozása ugyanannyiba kerül, mint a webes felületen
* A sikertelen API-kulcsos hitelesítési kísérletek korlátozva vannak (IP-címenként percenként 5)
* A használatodat a **Beállítások → Használat és korlátok** oldalon követheted

## Hibakezelés

Minden hiba JSON-t ad vissza `error` mezővel:

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

### HTTP-állapotkódok

| Állapot | Leírás |
| - | - |
| 400 | Bad Request - Érvénytelen kéréstörzs |
| 401 | Unauthorized - Érvénytelen vagy hiányzó API-kulcs |
| 402 | Payment Required - Nincs elég kredit |
| 403 | Forbidden - Nincs jogosultság, vagy nem megfelelő a munkaterület |
| 404 | Not Found - Az erőforrás nem található |
| 422 | Unprocessable Entity - Érvényesítési hiba |
| 429 | Too Many Requests - Túllépted a kérési korlátot |
| 500 | Internal Server Error - Szerveroldali hiba |
| 503 | Service Unavailable - A szerver foglalt, próbáld újra később |


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