パートナー側でのカタログ個人用設定

Xsolla Developers

または

パートナー側でのカタログ個人用設定Webhook POST

エクソラは、ユーザーがストアと対話するときに、ユーザーとプロジェクトのパラメータを含む partner_side_catalogウェブフックをウェブフックURLに送信します。

応答として、ユーザが利用可能なitem_idまたはアイテムSKUのリストを返します。この場合、特定のユーザーが特定の商品を指定回数購入できるという情報を含めることも可能です。この機能により、ユーザーがカートに追加して購入できる商品の数やタイプを制御することができます。

partner_side_catalogウェブフックの処理時間は3秒未満にすることをお勧めします。

Request

Request Body schema: application/json

required

object

ユーザーの詳細（オブジェクト）。

user_id required	string ユーザーID。ユーザーが認証されていない場合は、値`null`が送信されます。
country	string ユーザーの国。2文字の国コード（大文字）は、ISO 3166-1 alpha-2に従って使用されます。
currency	string 通貨。ISO 4217に基づく3文字の通貨コード。
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"
}
]