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

# Přehled API

> Vytvářejte a nasazujte webové aplikace pomocí Macaly API

Macaly API umožňuje externím aplikacím vytvářet chatové relace, budovat webové aplikace s pomocí AI a programově je nasazovat do produkce.

<Note>
  API je dostupné výhradně v rámci plánu Enterprise. [Kontaktujte nás](mailto:support@macaly.com) pro více informací o cenách a funkcích pro firmy.
</Note>

## Základní URL

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

## Jak začít

<Steps>
  <Step title="Získejte API klíč">
    Viz [Autentizace](/cs/api/authentication)
  </Step>

  <Step title="Vytvořte chat">
    Odešlete prompt a začněte vytvářet aplikaci
  </Step>

  <Step title="Počkejte na dokončení">
    Vyčkejte, než agent Macaly dokončí práci
  </Step>

  <Step title="Nasaďte">
    Publikujte aplikaci do produkce
  </Step>
</Steps>

## Dostupné endpointy

| Metoda | Endpoint                                                   | Popis                                 |
| ------ | ---------------------------------------------------------- | ------------------------------------- |
| POST   | [`/api/chat`](/cs/api/create-chat)                         | Vytvoření nového chatu                |
| POST   | [`/api/chat/{chatId}/publish`](/cs/api/publish-message)    | Odeslání zprávy do existujícího chatu |
| GET    | [`/api/chat/{chatId}/status`](/cs/api/get-status)          | Dotazování na stav workflow           |
| GET    | [`/api/chat/{chatId}/subscribe`](/cs/api/subscribe-stream) | Odběr real-time streamu               |
| POST   | [`/api/chat/{chatId}/deploy`](/cs/api/deploy)              | Nasazení chatu do produkce            |
| GET    | [`/api/chat/{chatId}/deployment`](/cs/api/get-deployment)  | Získání stavu nasazení                |

## Limity a kredity

* API požadavky spotřebovávají kredity z účtu vašeho týmu
* Vytvoření každého chatu stojí stejně jako při použití webového rozhraní
* Neúspěšné pokusy o autentizaci jsou omezeny (5 pokusů za minutu na IP adresu)
* Své využití můžete sledovat v **Nastavení → Využití a limity**

## Zpracování chyb

Všechny chyby vrací JSON s polem `error`:

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

### HTTP stavové kódy

| Kód | Popis                                                           |
| --- | --------------------------------------------------------------- |
| 400 | Bad Request – Neplatné tělo požadavku                           |
| 401 | Unauthorized – Neplatný nebo chybějící API klíč                 |
| 402 | Payment Required – Nedostatek kreditů                           |
| 403 | Forbidden – Nedostatečná oprávnění nebo nesprávný tým           |
| 404 | Not Found – Zdroj nenalezen                                     |
| 422 | Unprocessable Entity – Chyba validace                           |
| 429 | Too Many Requests – Překročen limit požadavků                   |
| 500 | Internal Server Error – Chyba na straně serveru                 |
| 503 | Service Unavailable – Server je zaneprázdněn, zkuste to později |