Přejít na hlavní obsah
GET
/
api
/
chat
/
{chatId}
/
status
Get Status
curl --request GET \
  --url https://macaly.com/api/chat/{chatId}/status \
  --header 'Authorization: Bearer <token>'
Slouží ke zjištění, v jakém stavu se nachází zpracování chatu. Hodí se, když chcete ověřit, zda AI dokončilo práci, aniž byste museli udržovat streamovací spojení.

Požadavek

GET /api/chat/{chatId}/status

Hlavičky

HlavičkaPovinnáPopis
AuthorizationAnoBearer macaly_...

Parametry cesty

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

Příklad požadavku

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

Odpověď

{
  "chatId": "abc123",
  "url": "https://www.macaly.com/chat/abc123",
  "status": "completed",
  "result": {
    "content": "Here's what I built for you..."
  }
}

Pole odpovědi

PoleTypPopis
chatIdstringID chatu
urlstringOdkaz pro zobrazení chatu v prohlížeči
statusstringAktuální stav zpracování (viz níže)
result.contentstringZávěrečná zpráva asistenta (pouze při stavu completed)
error.messagestringPopis chyby (pouze při stavu failed)

Hodnoty stavu

StavPopis
runningProbíhá zpracování
completedÚspěšně dokončeno
failedDošlo k chybě
cancelledZpracování bylo ručně zrušeno
no_active_workflowChat nemá žádnou aktivní úlohu

Stavové kódy

KódPopis
200Úspěch
401Neplatný nebo chybějící API klíč
403Chat nepatří vašemu týmu
404Chat nenalezen

Příklad pollingu

while true; do
  STATUS=$(curl -s https://www.macaly.com/api/chat/$CHAT_ID/status \
    -H "Authorization: Bearer macaly_...")

  echo "Status: $(echo $STATUS | jq -r .status)"

  if echo "$STATUS" | grep -q '"status":"completed"'; then
    echo "Done!"
    break
  fi

  sleep 2
done

Další kroky

Jakmile je stav completed, můžete:
  1. Nasadit aplikaci pomocí POST /api/chat/{chatId}/deploy