Shop Builder API (2.0.0)
- Version: 2.0.0
- Servers:
https://store.xsolla.com/api - Contact Us by Email
- Contact URL: https://xsolla.com/
- Required TLS version: 1.2
Shop Builder API provides a third-party solution for implementing the server side for your store interface. Use the endpoints to manage in-game items, in-game currencies, cart, player inventory, promotions, game library, etc.
개인 맞춤형 카탈로그
이 API를 사용하여 사용자 특성에 대한 규칙을 지정할 수 있습니다. 사용자가 구체적인 규칙에 대한 모든 조건을 충족하면 개인 맞춤형 아이템이 표시됩니다.
개인 맞춤형 프로모션에 대한 내용은 프로모션 섹션을 참조하십시오.
구매 전에 특성을 전달하려면 엑솔라 로그인 API를 사용하거나 페이 스테이션 API를 사용하여 토큰을 생성하는 동안 user.attributes 특성으로 특성을 전달할 수 있습니다.
- Mock serverhttps://xsolla.redocly.app/_mock/ko/api/shop-builder/v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}
- https://store.xsolla.com/api/v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
-u <username>:<password> \
https://xsolla.redocly.app/_mock/ko/api/shop-builder/v2/project/44056/admin/daily_chain/id/101- Mock serverhttps://xsolla.redocly.app/_mock/ko/api/shop-builder/v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}
- https://store.xsolla.com/api/v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
https://xsolla.redocly.app/_mock/ko/api/shop-builder/v2/project/44056/admin/daily_chain/id/101일일 보상 데이터를 성공적으로 조회했습니다.
일일 보상이 시작되는 날짜입니다.
일일 보상이 반복되는지 여부. true인 경우, 일일 보상은 종료일 이후 자동으로 초기화됩니다. 다음 start_date 및 end_date 일정은 일일 보상 단계 수와 start_date에 설정된 초기 시간에 기반합니다.
사용자가 보상을 청구할 수 있는 시점을 결정하는 일일 보상 유형입니다.
| 열거형 값 | 설명 |
|---|---|
| calendar_hard | 24시간마다 다음 단계 보상이 잠금 해제됩니다. 다음 단계 보상이 제공되기 시작하면 미수령 단계 보상은 영구적으로 소멸됩니다. |
| rolling_skippable |
|
| rolling_unskippable |
|
일일 보상이 종료되는 날짜입니다. null일 수 있습니다. 유형을 calendar_hard로 설정하면 이 날짜가 추가된 걸음 수에 따라 자동으로 설정되므로 이 부분을 null로 둘 수 있습니다.
아이템 설명에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 다섯 글자 로케일 코드(예: en-US) 두 가지 형식 중 하나로 되어 있는 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 옵션(예: en 및 en-US)이 모두 제공되면 마지막으로 제공된 값이 저장됩니다. 지원되는 언어의 전체 목록은 문서에서 확인할 수 있습니다.
아이템 설명에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 다섯 글자 로케일 코드(예: en-US) 두 가지 형식 중 하나로 되어 있는 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 옵션(예: en 및 en-US)이 모두 제공되면 마지막으로 제공된 값이 저장됩니다. 지원되는 언어의 전체 목록은 문서에서 확인할 수 있습니다.
아이템 이름에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 다섯 글자 언어 코드(예: en-US) 두 가지 형식 중 하나로 되어 있는 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 옵션(예: en 및 en-US)이 모두 제공되면 마지막으로 제공된 값이 저장됩니다. 지원되는 언어의 전체 목록은 문서에서 확인할 수 있습니다.
아이템 이름에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 다섯 글자 언어 코드(예: en-US) 두 가지 형식 중 하나로 되어 있는 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 옵션(예: en 및 en-US)이 모두 제공되면 마지막으로 제공된 값이 저장됩니다. 지원되는 언어의 전체 목록은 문서에서 확인할 수 있습니다.
일일 보상에서 구성한 걸음 수입니다. 여기서 각 걸음은 일일 보상의 하루를 의미합니다.
{ "date_end": "2025-04-25T18:16:00+05:00", "date_start": "2023-04-15T18:16:00+05:00", "description": { "en": "Daily reward short description" }, "id": 3, "is_enabled": true, "is_recurrent": false, "name": { "en": "Daily reward", "ru": "Ежедневная награда" }, "number_of_steps": 3, "order": 1, "steps": [ { … }, { … }, { … } ], "type": "calendar_hard" }
calendar_hard 유형의 일일 보상입니다.
일일 보상이 시작되는 날짜입니다.
일일 보상이 반복되는지 여부. true인 경우, 일일 보상은 종료일 이후 자동으로 초기화됩니다. 다음 start_date 및 end_date 일정은 일일 보상 단계 수와 start_date에 설정된 초기 시간에 기반합니다.
사용자가 보상을 청구할 수 있는 시점을 결정하는 일일 보상 유형입니다.
| 열거형 값 | 설명 |
|---|---|
| calendar_hard | 24시간마다 다음 단계 보상이 잠금 해제됩니다. 다음 단계 보상이 제공되기 시작하면 미수령 단계 보상은 영구적으로 소멸됩니다. |
| rolling_skippable |
|
| rolling_unskippable |
|
아이템 설명에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 다섯 글자 로케일 코드(예: en-US) 두 가지 형식 중 하나로 되어 있는 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 옵션(예: en 및 en-US)이 모두 제공되면 마지막으로 제공된 값이 저장됩니다. 지원되는 언어의 전체 목록은 문서에서 확인할 수 있습니다.
아이템 설명에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 다섯 글자 로케일 코드(예: en-US) 두 가지 형식 중 하나로 되어 있는 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 옵션(예: en 및 en-US)이 모두 제공되면 마지막으로 제공된 값이 저장됩니다. 지원되는 언어의 전체 목록은 문서에서 확인할 수 있습니다.
아이템 이름에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 다섯 글자 언어 코드(예: en-US) 두 가지 형식 중 하나로 되어 있는 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 옵션(예: en 및 en-US)이 모두 제공되면 마지막으로 제공된 값이 저장됩니다. 지원되는 언어의 전체 목록은 문서에서 확인할 수 있습니다.
아이템 이름에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 다섯 글자 언어 코드(예: en-US) 두 가지 형식 중 하나로 되어 있는 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 옵션(예: en 및 en-US)이 모두 제공되면 마지막으로 제공된 값이 저장됩니다. 지원되는 언어의 전체 목록은 문서에서 확인할 수 있습니다.
일일 보상 단계의 고유 식별자입니다. 이 단계에 대한 사용자 진행 상황을 유지하려면 업데이트 중에 지정합니다.
- Mock serverhttps://xsolla.redocly.app/_mock/ko/api/shop-builder/v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}
- https://store.xsolla.com/api/v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
-u <username>:<password> \
https://xsolla.redocly.app/_mock/ko/api/shop-builder/v2/project/44056/admin/daily_chain/id/101 \
-H 'Content-Type: application/json' \
-d '{
"date_start": "2023-04-15T18:16:00+05:00",
"description": {
"en": "Updated daily reward description"
},
"is_enabled": true,
"name": {
"en": "Updated daily reward",
"ru": "Обновленная ежедневная награда"
},
"order": 4,
"steps": [
{
"items": [
{
"quantity": 1,
"sku": "vg_enabled_shown_in_store_1"
}
],
"step_number": 1
},
{
"items": [
{
"quantity": 1,
"sku": "vg_enabled_shown_in_store_2"
}
],
"step_number": 2
},
{
"items": [
{
"quantity": 1,
"sku": "vg_not_shown_in_store"
}
],
"step_id": 10,
"step_number": 3
},
{
"items": [
{
"quantity": 1,
"sku": "bundle_enabled_shown_in_store_with_2_enabled_shown_in_store_vg"
}
],
"step_id": 8,
"step_number": 4
},
{
"items": [
{
"quantity": 1,
"sku": "vcp_enabled_shown_in_store_1_of_10_vc_enabled_shown_in_store_1"
}
],
"step_number": 5
}
],
"type": "calendar_hard"
}'