Quickstart - preezie API

This quickstart will become the shortest path from receiving credentials to making a successful API request.

1. Select an environment

Choose the appropriate base URL from Environments.

2. Configure authentication

Follow the instructions in Authentication.

3. Send a request

Use the operation token returned by the widget SDK and your tenant identifier to call a Core Intent endpoint. The following example sends a product-search request:

curl --no-buffer --request POST \
  "$PREEZIE_API_URL/api/operation/search" \
  --header "Authorization: Bearer $PREEZIE_OPERATION_TOKEN" \
  --header "Tenantid: $PREEZIE_TENANT_ID" \
  --header "Content-Type: application/json" \
  --data '{
    "sessionId": "session-123",
    "visitorId": "visitor-456",
    "content": "Show me lightweight black running shoes",
    "requestOrigin": "Operation",
    "pageSize": 12,
    "operationHideAiMessage": false,
    "operationReturnFullProductInfo": false,
    "chatMetadata": {
      "websiteUrl": "https://shop.example.com/collections/running"
    }
  }'

The response is streamed as text/event-stream, so read each data: line as an independent JSON message. See Search for products for the request fields and response format.