Significant OpenAPI Updates

Dear Developer,

Please note the following changes:

1.OpenAPI will support to set and search Multiple Tier Bundle deal.Multiple Tier Bundle deal will make buyers buy different amount of products with different promotion, the number of tier we support cannot exceed 3 now.You can use new parameter "additional_tiers" in Bundle deal relater APIs to set or search the information of additional Bundle deal tier, for example:

Use v2.bundle_deal.get_bundle_deal to get Multiple Tier Bundle deal.

Use v2.bundle_deal.add_bundle_deal to add Multiple Tier Bundle deal.

Use v2.bundle_deal.update_bundle_deal to update Multiple Tier Bundle deal.

Moreover, when you are adding or updating Multiple Tier Bundle deal, you need to pay attention to satisfy the rule of Multiple Tier Bundle deal，you can refer to this FAQ for more details.

Related APIs:

v2.bundle_deal.get_bundle_deal_list

v2.bundle_deal.get_bundle_deal

v2.bundle_deal.add_bundle_deal

v2.bundle_deal.update_bundle_deal

Effective Date on Live: 2022/8/29

2.When you are using v2.sellerchat.send_message API to send message with image type, Shopee will verify whether this image includes blacklist keyword. As long as Shopee verifies that it has blacklist keyword, this API call of sending message will fail with below error message:

{ "error": "message_is_censored", "message": "Message is censored due to blacklist keywords.", "request_id": "d967995a22344c7ef252745afa22127b", "response": {} }

If you call v2.sellerchat.get_message，you will be able to get that message whose status will be censored_blacklist

{ "status": "censored_blacklist" }

Related APIs:

v2.sellerchat.send_message

v2.sellerchat.get_message

Effective Date on Live: 2022/8/29

尊敬的开发者，

请注意以下变动：

1.OpenAPI将支持多层级的Bundle deal的设置与查询。多层级的Bundle deal可以让买家购买的商品在满足不同的数量要求时，获得阶梯型的折扣。现在支持的层级总数不超过3层，您可以通过在Bundle deal相关接口中的新增字段"additional_tiers"，来设置或查询额外层级的Bundle deal的信息，例如

调用v2.bundle_deal.get_bundle_deal将能够返回多层级的bundle deal。

调用v2.bundle_deal.add_bundle_deal支持添加多层级的bundle deal。

调用v2.bundle_deal.update_bundle_deal支持更新为多层级的bundle deal

其中，在上传或更新多层级的bundle deal时，需要满足多层级bundle deal的折扣设置规则，具体规则请参考这篇FAQ

影响接口：

v2.bundle_deal.get_bundle_deal_list

v2.bundle_deal.get_bundle_deal

v2.bundle_deal.add_bundle_deal

v2.bundle_deal.update_bundle_deal

上线时间：2022/8/29

2.在您使用Chat OpenAPI的v2.sellerchat.send_message接口发送图片类消息，Shopee将会校验此图片中是否含有违规信息，一旦Shopee检测出违规信息，那么与违规的文字消息一样，此图片消息的发送也将会失败并返回以下报错

{ "error": "message_is_censored", "message": "Message is censored due to blacklist keywords.", "request_id": "d967995a22344c7ef252745afa22127b", "response": {} }

如果您调用v2.sellerchat.get_message，您将可以查到发送失败的该条消息，其状态为censored_blacklist

{ "status": "censored_blacklist" }

影响接口：

v2.sellerchat.send_message

v2.sellerchat.get_message

上线时间：2022/8/29