跳至主要内容

Coupon and creator IDs limited to 32 characters

What's new

The 32-character cap on resource-reference ID fields now covers the coupon and creator endpoints. It applies to id, category_id, applicable_item_ids, order_item_id, the free-item item_id, and the creator fields creator_id, creator_tier_group_id, and current_creator_tier_id.

This completes the rollout that started on catalog, store, and promotion endpoints and continued through graph nodes and page blocks.

Impact

An ID longer than 32 characters in any of these request fields is now rejected by validation. Aghanim resource IDs are already 32 characters or shorter, so callers passing valid IDs are unaffected. The same cap is documented on the response schemas, which tells generated clients the field width to expect.

Changes

ResourceChange
create_couponcategory_id, each entry of applicable_item_ids, and the free_items entry item_id capped at 32 characters
update_couponcategory_id, applicable_item_ids, and free-item item_id capped at 32 characters
bulk_update_couponid and category_id request fields capped at 32 characters
get_coupons, get_couponid, category_id, and applicable_item_ids declared with the 32-character cap in responses
get_user_couponsid, category_id, applicable_item_ids, and order_item_id declared with the 32-character cap
create_creator, update_creatorcreator_tier_group_id capped at 32 characters
get_creator, get_creatorsid, creator_tier_group_id, current_creator_tier_id, and the terms.id capped at 32 characters
Coupon creator_program objectcreator_id capped at 32 characters, on both coupon requests and responses

Upgrade

  • No action required if you send standard Aghanim resource IDs. If you generate or forward IDs from another system, ensure they do not exceed 32 characters.

需要技术支持?
联系我们的集成技术团队: integration@aghanim.com