/ssapi/choose

POST

/ssapi/choose

Get the chosen variations for one or more campaigns.

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

🟠401Unauthorized

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/ssapi/choose' \
--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"
        }
    },
    "selector": {
        "names": [
            "test_selector"
        ]
    }
}'

Response Example

200 - APIRecsCampaign

{
    "choices": [
        {
            "name": "test recs campaign",
            "type": "RECS_DECISION",
            "decisionId": "unique token",
            "variations": {
                "name": "variation A",
                "payload": {
                    "type": "RECS",
                    "data": {
                        "slots": [
                            {
                                "sku": "sku_1",
                                "productData": {
                                    "categories": [
                                        "a",
                                        "b"
                                    ],
                                    "price": 100
                                },
                                "slotId": "unique slot token"
                            },
                            {
                                "sku": "sku_2",
                                "productData": {
                                    "categories": [
                                        "a",
                                        "b"
                                    ],
                                    "price": 200
                                },
                                "slotId": "unique slot token"
                            }
                        ]
                    }
                }
            }
        }
    ]
}

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

/ssapi/engagement

addToCart