/ssapi/engagement

POST

/ssapi/engagement

Report user engagement (clicks) with a variation or a recommended item.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Successful response

Body

🟢204No Content

🟠401Unauthorized

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

cURL

EventAPIViewWidgetEventHybridMultipleInvalidContextData

curl --location --request POST '/ssapi/engagement' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user": {
        "id": "100"
    },
    "session": {
        "custom": "custom_session_100"
    },
    "context": {
        "page": {
            "type": "PRODUCT",
            "data": [
                "sku_1"
            ],
            "location": "https://test.ru/product/sku_1"
        },
        "device": {
            "userAgent": "Mozilla/5.0 ...",
            "ip": "8.8.8.8"
        }
    },
    "engagements": [
        {
            "type": "WRIMP",
            "decisionId": "65f2a818f56efdf37c00228b:65f2a818f56efdf37c002294:65f2a818f56efdf37c00228e:65f2a818f56efdf37c002292"
        }
    ]
}'

Response Example

200 - EventHybridMultiple

{
    "session": {
        "sl": "58DA42F2-BD26-4517-A81B-4DA4369E2529"
    }
}

Modified at 2025-07-30 13:23:50

/ssapi/event

/ssapi/choose