Endpoints

Implementeren

Implementeer een chat in productie

POST/api/chat/{chatId}/deploy

Implementeert een chat in productie. Start een implementatie op Vercel en retourneert onmiddellijk.

Verzoek

POST /api/chat/{chatId}/deploy

Headers

HeaderVereistBeschrijving
AuthorizationJaBearer macaly_...

Padparameters

ParameterTypeBeschrijving
chatIdstringDe chat-ID om te implementeren

Voorbeeldverzoek

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

Respons

{
  "id": "jzga0sttml37v6mbizb8tk1x",
  "url": "https://macaly-staging-abc123.macaly.app",
  "status": "QUEUED",
  "deploymentId": "dpl_HKLBd2QDTwq58AMUJiaMyUzk8WUw"
}

Responsvelden

VeldTypeBeschrijving
idstringDatabase-implementatie-ID
urlstringDe implementatie-URL
status"QUEUED" | "BUILDING"Initiële status
deploymentIdstringVercel-implementatie-ID

Statuscodes

StatusBeschrijving
200Implementatie gestart
400Ongeldig verzoek (bijv. geen berichten in de chat)
401Ongeldige of ontbrekende API-sleutel
403Geen toestemming om te implementeren OF chat behoort niet tot het team
404Chat niet gevonden
500Interne serverfout

Opmerkingen

Dit endpoint retourneert onmiddellijk na het starten van de implementatie. De implementatie vindt asynchroon plaats op Vercel.

  • Gebruik GET /api/chat/{chatId}/deployment met deploymentId ingesteld op de geretourneerde id om de voortgang te volgen
  • Vereist de hosting.publish_macaly-toestemming

Volgende stappen

Na het starten van een implementatie:

  1. Volg de voortgang met GET /api/chat/{chatId}/deployment, met deploymentId ingesteld op de geretourneerde id
  2. Wacht tot de status READY wordt