获取当前用户的优惠链

Xsolla Developers

或

前往发布商帐户

获取当前用户的优惠链Client-side

get/v2/project/{project_id}/user/offer_chain

获取当前用户的优惠链。

注意

所有项目的单次响应中返回的商品数量都有上限。默认值和最大值为每次响应30个商品。如需更多数据，可通过limit与offset参数分页获取。

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id

required

integer

项目ID。您可以在您的发布商帐户项目名称旁边找到。

Example: 44056

query Parameters

limit	integer >= 1 页面上元素数量的限制。 Example: limit=50
offset	integer >= 0 元素编号，从该元素开始生成列表（从0开始数）。 Example: offset=0

Responses

200

优惠链列表接收成功。

Request samples

Response samples

application/json

{"has_more": false,
"items": [{"date_end": "2025-04-25T18:16:00+05:00",
"date_start": "2018-04-15T18:16:00+05:00",
"description": null,
"id": 101,
"name": "Active offer chain",
"next_step_number": 1,
"order": 1,
"recurrent_schedule": null,
"steps": [{"is_claimed": false,
"is_free": false,
"items": [{"description": "Heal 10% of your health",
"image_url": "https://picture.bundle-picture.png",
"is_free": false,
"item_id": 9012,
"name": "Healing potion",
"order": 0,
"quantity": 1,
"sku": "health_potion",
"type": "virtual_good"
}
],
"step_number": 1,
"step_price": {"amount": 99.99,
"currency": "USD"
},
"step_vp_rewards": [{"amount": 15,
"image_url": "https://popmedia.blob.core.windows.net/popyourself/female/accessory/female_crossnecklace_2_silver-01.png",
"is_clan": true,
"item_id": 6039,
"name": "store_item_0_test_value_point_name",
"sku": "test_value_point_39"
}
]
},
{"is_claimed": false,
"is_free": false,
"items": [{"description": "Heal 10% of your health",
"image_url": "https://picture.bundle-picture.png",
"is_free": false,
"item_id": 9012,
"name": "Healing potion",
"order": 0,
"quantity": 2,
"sku": "health_potion",
"type": "virtual_good"
}
],
"step_number": 2,
"step_price": {"amount": 199.98,
"currency": "USD"
},
"step_vp_rewards": [{"amount": 30,
"image_url": "https://popmedia.blob.core.windows.net/popyourself/female/accessory/female_crossnecklace_2_silver-01.png",
"is_clan": true,
"item_id": 6039,
"name": "store_item_0_test_value_point_name",
"sku": "test_value_point_39"
}
]
},
{"is_claimed": false,
"is_free": true,
"items": [{"description": "store_item_0_lost_telescope_2_short_description",
"image_url": "https://picture.bundle-picture.png",
"is_free": true,
"item_id": 9011,
"name": "Free item",
"order": 0,
"quantity": 1,
"sku": "free_item",
"type": "virtual_good"
}
],
"step_number": 3,
"step_price": null,
"step_vp_rewards": null
}
]
},
{"date_end": "2025-04-25T18:16:00+05:00",
"date_start": "2018-04-15T18:16:00+05:00",
"description": null,
"id": 102,
"name": "Active offer chain 2",
"next_step_number": 1,
"order": 1,
"recurrent_schedule": null,
"steps": [{"is_claimed": false,
"is_free": true,
"items": [{"description": "store_item_0_lost_telescope_2_short_description",
"image_url": "https://picture.bundle-picture.png",
"is_free": true,
"item_id": 9011,
"name": "Free item",
"order": 0,
"quantity": 3,
"sku": "free_item",
"type": "virtual_good"
}
],
"step_number": 1,
"step_price": null,
"step_vp_rewards": null
},
{"is_claimed": false,
"is_free": true,
"items": [{"description": "Heal 10% of your health",
"image_url": "https://picture.bundle-picture.png",
"is_free": false,
"item_id": 9012,
"name": "Healing potion",
"order": 0,
"quantity": 3,
"sku": "health_potion",
"type": "virtual_good"
}
],
"step_number": 2,
"step_price": null,
"step_vp_rewards": [{"amount": 45,
"image_url": "https://popmedia.blob.core.windows.net/popyourself/female/accessory/female_crossnecklace_2_silver-01.png",
"is_clan": true,
"item_id": 6039,
"name": "store_item_0_test_value_point_name",
"sku": "test_value_point_39"
}
]
},
{"is_claimed": false,
"is_free": true,
"items": [ ],
"step_number": 3,
"step_price": null,
"step_vp_rewards": null
}
]
},
{"date_end": "2025-04-25T18:16:00+05:00",
"date_start": "2018-04-15T18:16:00+05:00",
"description": null,
"id": 103,
"name": "Active offer chain 3",
"next_step_number": 1,
"order": 1,
"recurrent_schedule": null,
"steps": [{"is_claimed": false,
"is_free": true,
"items": [{"description": "store_item_0_lost_telescope_2_short_description",
"image_url": "https://picture.bundle-picture.png",
"is_free": true,
"item_id": 9011,
"name": "Free item",
"order": 0,
"quantity": 3,
"sku": "free_item",
"type": "virtual_good"
}
],
"step_number": 1,
"step_price": null,
"step_vp_rewards": null
},
{"is_claimed": false,
"is_free": false,
"items": [{"description": "Heal 10% of your health",
"image_url": "https://picture.bundle-picture.png",
"is_free": false,
"item_id": 9012,
"name": "Healing potion",
"order": 0,
"quantity": 3,
"sku": "health_potion",
"type": "virtual_good"
}
],
"step_number": 2,
"step_price": {"amount": 299.97,
"currency": "USD"
},
"step_vp_rewards": [{"amount": 45,
"image_url": "https://popmedia.blob.core.windows.net/popyourself/female/accessory/female_crossnecklace_2_silver-01.png",
"is_clan": true,
"item_id": 6039,
"name": "store_item_0_test_value_point_name",
"sku": "test_value_point_39"
}
]
},
{"is_claimed": false,
"is_free": true,
"items": [ ],
"step_number": 3,
"step_price": null,
"step_vp_rewards": null
}
]
}
],
"total_items_count": 3
}