API och integrationer Headless commerce Shoppingassistent

Shoppingassistent

The shopping assistant: a server-sent event stream that answers product questions against the channel's own catalogue and content.

1 anrop POST Bas-URL https://api.erp.fluit.cloud/ecom

Autentisering, felkoder, rate limits, idempotens och paginering gäller alla anrop och står samlade under Kom igång.

POST /chat/stream

Ask the shopping assistant

Answers a shopper's question against the channel's own catalogue and content, and streams the reply as server-sent events rather than returning a body. Each event is a `data:` line carrying a JSON fragment; concatenate the text fragments as they arrive and stop at the terminating event.

Visa hela beskrivningen

Because the response is a stream, the 200 has no schema to document — read the event format from the frames themselves. Requires a session, and is enabled per channel through the enableChatAssistant feature flag.

Body krävs

Fält	Typ
`content`	string · nullable
`currentCategory`	string · nullable
`currentProductId`	string · nullable
`currentProductName`	string · nullable
`history`	ChatMessageDto[] · nullable

Svar

200 Tom body.

Standardfel: 400429 Felhantering

Exempel

curl

curl -X POST "https://api.erp.fluit.cloud/ecom/chat/stream" \
  -H "X-Tenant-Id: $FLUIT_TENANT_ID" \
  -H "X-Channel: web" \
  -H "Content-Type: application/json" \
  -d @body.json

Bas-URL https://api.erp.fluit.cloud/ecom.

Scheman

Objekten som gruppens anrop refererar till. Fälttabellerna ovan går ett steg djupt och länkar hit i stället för att upprepa samma schema på varje endpoint.

ChatMessageDto


                      EcomChatMessageDto

Fält	Typ
`content`	string · nullable
`role`	string · nullable