快工助手跨境电商知识与商机助手

Significant OpenAPI Updates

Shopee 官方资料 · Shopee Open Platform 变更通知(Announcements) · 适合开发者

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
Shopee / profile.shopee.announcements
语言
en
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/shopeeaudience/developercategory/announcementtopic/apitopic/api-paymenttopic/changelogtopic/developertopic/openapi-updatestopic/platform-function-updates

资料正文

§1 Significant OpenAPI Updates

尊敬的开发者,请留意以下变动:

1.目前,如果open api用户因为网络波动导致无法获取到最新的refresh token和access token时需要卖家重新授权,我们对此做了相关的优化:

原流程:refresh token一次有效,重新授权和调用RefreshAccesstoken api 都会触发刷新refresh token, 被刷新后无论open api用户是否成功获取到新的refresh token,旧的refresh token均会失效

优化后:refresh token非一次性有效,被刷新后,4小时内继续有效,open api用户在4小时内重复使用旧的refresh token调用RefreshAccessToken api 都会返回相同的最新的refresh token,如果超过4个小时,旧的refresh token也将会失效,卖家只能重新授权。

影响接口:

RefreshAccessToken

上线时间:2021/12/30

2.Shopee于2021年9月底在马来西亚和越南推出了物品保护保险(由买家支付),所以在OpenAPI v2.0 get_escrow_detail返参新增final_product_protection来说明买家支付的物品保护保险。

影响接口:

v2.0 get_escrow_detail

上线时间:2021/12/24

Dear Developer,

Please find below updates:

1.At present, if open api user cannot obtain the latest refresh token and access token due to network fluctuations, seller need to re-authorized their shops. We have made relevant optimizations for this:

Original logic: The refresh token is valid once, re-authorization or calling the RefreshAccesstoken api will trigger to refresh the token. After being refreshed, regardless of whether the open api user has obtained the new refresh token, the original refresh token will be invalid.

After optimization: The refresh token is not one-time use. After being refreshed, original refresh token will continue to be valid within 4 hours. Open api user can use the old refresh token repeatedly to call the RefreshAccessToken api within 4 hours and api will return the same latest refresh token. If more than 4 hours, the open api user still does not get the latest refresh token, the old refresh token will also become invalid, and the seller can only re-authorize their shops.

Related API:RefreshAccessToken

Effective Date on Live: 2021/12/30

2.Shopee launched item protection insurance (paid by buyer) in Malaysia and Vietnam in late September 2021. So OpenAPI v2.0 get_escrow_detail api add "final_product_protection" field to indicate the item protection insurance paid by the buyer.

Related API: v2.0 get_escrow_detail

Effective Date on Live: 2021/12/24

#