Přejít na hlavní obsah
Macaly API umožňuje externím aplikacím vytvářet chatové relace, budovat webové aplikace s pomocí AI a programově je nasazovat do produkce.
API je dostupné výhradně v rámci plánu Enterprise. Kontaktujte nás pro více informací o cenách a funkcích pro firmy.

​
Základní URL

https://www.macaly.com

​
Jak začít

1

Získejte API klíč

Viz Autentizace
2

Vytvořte chat

Odešlete prompt a začněte vytvářet aplikaci
3

Počkejte na dokončení

Vyčkejte, než agent Macaly dokončí práci
4

Nasaďte

Publikujte aplikaci do produkce

​
Dostupné endpointy

MetodaEndpointPopis
POST/api/chatVytvoření nového chatu
POST/api/chat/{chatId}/publishOdeslání zprávy do existujícího chatu
GET/api/chat/{chatId}/statusDotazování na stav workflow
GET/api/chat/{chatId}/subscribeOdběr real-time streamu
POST/api/chat/{chatId}/deployNasazení chatu do produkce
GET/api/chat/{chatId}/deploymentZí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: 
{
  "error": "Error message here"
}

​
HTTP stavové kódy

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