Přejít na hlavní obsah
GET
/
api
/
chat
/
{chatId}
/
subscribe
Subscribe to Stream
curl --request GET \
  --url https://macaly.com/api/chat/{chatId}/subscribe \
  --header 'Authorization: Bearer <token>'
Umožňuje odebírat aktivní stream chatu a přijímat odpovědi AI v reálném čase. Alternativa k opakovanému dotazování přes endpoint Get Status.

​
Požadavek

GET /api/chat/{chatId}/subscribe

​
Hlavičky

HlavičkaPovinnáPopis
AuthorizationAnoBearer macaly_...

​
Parametry cesty

ParametrTypPopis
chatIdstringID chatu vrácené z POST /api/chat

​
Příklad požadavku

curl -N https://www.macaly.com/api/chat/abc123/subscribe \
  -H "Authorization: Bearer macaly_abc123..."

​
Odpověď

Vrací Server-Sent Events (SSE) stream s průběhem zpracování a odpověďmi AI.

​
Formát streamu

Stream používá protokol Vercel AI SDK v4 data stream. Každý chunk má na začátku prefix určující typ obsahu:
PrefixPopis
0:Textový obsah
2:Datové objekty (např. { chatId })
8:Anotace a metadata

​
Příklad streamu

2:[{"chatId":"abc123"}]
0:"I'll create a landing page for you."
0:" Let me start by setting up the project structure."
8:{"type":"tool-call","toolName":"WriteFile",...}
0:" Done! Your landing page is ready."

​
Stavové kódy

KódPopis
200Úspěch (streaming odpověď)
204Žádný aktivní stream – zpracování už skončilo, nebo ještě nezačalo
401Neplatný nebo chybějící API klíč
403Chat nepatří vašemu týmu
404Chat nenalezen
429Překročen limit požadavků

​
Poznámky

  • Stream se ukončí, jakmile AI dokončí práci
  • Pokud tento endpoint zavoláte po dokončení zpracování, vrátí se 204 No Content
  • Pro jednodušší implementaci stačí průběžně kontrolovat stav přes endpoint Get Status