주요 콘텐츠로 건너뛰기

Apple-specific image URL fields on items

What's new

Five Apple-specific image URL fields are now exposed on item responses across all item-bearing endpoints: image_url_apple, image_url_featured_apple, icon_url_apple, background_image_url_apple, and featured_card_background_image_url_apple. All five fields are marked deprecated on introduction.

Impact

These fields surface the previously internal Apple-specific image variants on items, lootboxes, subscriptions, and virtual currencies wherever item data is returned. Because they are deprecated, do not build new integrations against them — use the standard image_url, icon_url, background_image_url, and featured_card_background_image_url fields instead.

Changes

ResourceChange
get_item, get_items, create_item, update_item, bulk_create_or_update_items, bulk_update_items, translate_itemAdded deprecated optional Apple image URL fields to item responses
get_store_items, get_all_store_items, get_user_store_items, get_campaign_store_items, create_store_item, update_store_item, bulk_update_store_itemsAdded deprecated optional Apple image URL fields to all nested item subtypes in response
get_coupon, get_coupons, get_user_coupons, create_coupon, update_coupon, bulk_update_couponAdded deprecated optional Apple image URL fields to item in response
get_cashback_reward, get_cashback_rewards, create_cashback_reward, update_cashback_rewardAdded deprecated optional Apple image URL fields to item in response
get_daily_reward, get_daily_rewards, create_daily_reward, update_daily_reward, copy_daily_rewardAdded deprecated optional Apple image URL fields to all nested item types in response
get_loyalty_tiers, update_loyalty_tiersAdded deprecated optional Apple image URL fields to tier item responses

Upgrade

  • Continue to read the standard image URL fields (image_url, icon_url, background_image_url, featured_card_background_image_url, image_url_featured) — they remain the source of truth.
  • Treat the new *_apple fields as deprecated. Do not depend on them for new work; plan to remove any references in existing integrations.

도움이 필요하세요?
통합팀에 문의하십시오 [email protected]