合作伙伴侧的目录个性化

Xsolla Developers

或

前往发布商帐户

合作伙伴侧的目录个性化Webhook POST

当用户与商店交互时，艾克索拉会将包含用户和项目参数的partner_side_catalog webhook发送到webhook URL。

返回适用于该用户的item_id或商品SKU的列表。您也可以在其中包含指定用户对指定商品的可购买次数的信息。此功能允许您控制用户可添加到购物车及可购买的商品种类和次数。

建议partner_side_catalog webhook的处理时间小于3秒。

Request

Request Body schema: application/json

required

object

用户详情（对象）。

user_id required	string 用户ID。如果用户未认证身份，则发送值`null`。
country	string 用户所在国家/地区。使用ISO 3166-1 alpha-2 标准规定的2字母组合表示国家/地区。
currency	string 货币。符合ISO 4217的三字母货币代码。
locale	string 用户语言。2字母（小写字母）语言代码。

Responses

200

返回对该用户可用的商品列表以及特定用户可以购买特定商品的次数。

404

找不到用户。

Request samples

CURL
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'authorization: Signature d90d319f05df7b0f86d2485f48e7079f0f752523' \
-d '{
        "notification_type": "partner_side_catalog",
        "user": {
            "user_id": "12345",
            "country": "US"
        }
    }'

Response samples

application/json

[{"date_from": "2024-08-11T23:59:59+08:00",
"date_until": "2024-08-12T23:59:59+08:00",
"quantity": 0,
"sku": "com.xsolla.boots_1"
},
{"date_from": "2024-08-11T23:59:59+08:00",
"date_until": "2024-08-12T23:59:59+08:00",
"quantity": null,
"sku": "com.xsolla.sword_1"
},
{"quantity": 1,
"sku": "com.xsolla.helmet_1"
},
{"content": [{"description": "Description of custom content item",
"image_url": "https://example.com/content_image.png",
"name": "Custom content item",
"quantity": 5
}
],
"description": "Custom description",
"image_url": "https://example.com/image.png",
"json_attributes": {"purchased": 0,
"type": "lootbox"
},
"name": "Custom name",
"quantity": null,
"sku": "com.xsolla.custom_item_1"
}
]