Status ophalen

Vraagt de status van een chatworkflow op. Handig om te controleren of een chat klaar is met verwerken zonder een streamingverbinding te onderhouden.

Verzoek

GET /api/chat/{chatId}/status

Headers

Header	Vereist	Beschrijving
`Authorization`	Ja	`Bearer macaly_...`

Padparameters

Parameter	Type	Beschrijving
`chatId`	string	De chat-ID die is geretourneerd door `POST /api/chat`

Voorbeeldverzoek

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

const response = await fetch(
  `https://www.macaly.com/api/chat/${chatId}/status`,
  {
    headers: {
      'Authorization': 'Bearer macaly_abc123...',
    },
  }
);

const data = await response.json();
console.log(data.status);

import requests

response = requests.get(
    f'https://www.macaly.com/api/chat/{chat_id}/status',
    headers={
        'Authorization': 'Bearer macaly_abc123...',
    },
)

data = response.json()
print(data['status'])

Respons

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

Responsvelden

Veld	Type	Beschrijving
`chatId`	string	De chat-ID
`url`	string	URL om de chat in de browser te bekijken
`status`	string	Huidige workflowstatus (zie hieronder)
`result.content`	string	Laatste assistentbericht (alleen bij `completed`)
`error.message`	string	Foutbeschrijving (alleen bij `failed`)

Statuswaarden

Status	Beschrijving
`running`	Workflow wordt momenteel uitgevoerd
`completed`	Succesvol afgerond
`failed`	Er is een fout opgetreden
`cancelled`	Workflow is handmatig geannuleerd
`no_active_workflow`	Geen workflow gevonden voor deze chat

Statuscodes

Status	Beschrijving
200	Succes
401	Ongeldige of ontbrekende API-sleutel
403	Chat behoort niet tot uw team
404	Chat niet gevonden

Pollingpatroon

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 -qE '"status":"(completed|failed|cancelled)"'; then
    echo "Done!"
    break
  fi

  sleep 2
done

Volgende stappen

Zodra de status completed is, kunt u:

De app implementeren met POST /api/chat/{chatId}/deploy