跳至主要内容

Unified item source enum across catalog and order responses

What's new

The two per-domain ItemSource schemas (one for catalog items, one for order items) have been consolidated into a single shared ItemSource enum. The combined enum now spans every channel through which a player can receive an item: order, bonus, bundle, coupon, lootbox, free_item, liveops, daily_reward, loyalty_reward, progression_program, rolling_offer, and pick_one_offer.

Impact

  • Order and payment item responses can now surface bundle, coupon, lootbox, and the new liveops/reward sources — previously they only reported order or bonus.
  • Catalog item responses (items, store items, coupons, daily rewards, cashback rewards, loyalty tiers, pages) gain the new liveops/reward source values to describe items distributed through dailies, free-item drops, liveops events, loyalty rewards, progression programs, rolling offers, and pick-one offers.
  • On catalog responses, source now reports a default value of order when no explicit source is set.
  • In order and payment responses, the nested item source is now a required field.

Changes

ResourceChange
ComponentsRemoved aghanim__item__schemas__ItemSource and aghanim__s2s__order__schemas__ItemSource; added a single shared ItemSource
get_orderItem source adds bundle, coupon, lootbox, daily_reward, free_item, liveops, loyalty_reward, pick_one_offer, progression_program, rolling_offer; nested item source is now required
update_orderSame as get_order
get_paymentsNested payment item source is now required
Catalog endpoints (items, store items, coupons, daily rewards, cashback rewards, loyalty tiers, pages)Item source adds the seven new values: daily_reward, free_item, liveops, loyalty_reward, pick_one_offer, progression_program, rolling_offer; source defaults to order

Upgrade

  • If you reference aghanim__item__schemas__ItemSource or aghanim__s2s__order__schemas__ItemSource in generated client types, regenerate against the new spec and switch to the shared ItemSource.
  • Widen any switch statements or validators on item source to accept the new enum values; treat unknown values as a forward-compatible fallback to keep new sources from breaking older clients.
  • For order and payment responses, treat the nested item source as guaranteed to be present.

需要技术支持?
联系我们的集成技术团队: [email protected]