## 接口说明
有赞云应用分工具型(服务多店铺,走 OAuth code 授权)与自用型(服务自家店铺,免授权码)。自用型应用调用本接口,以 authorize_type=silent 直接换取店铺维度的 access_token:参数为 client_id、client_secret、kdt_id(店铺 ID,可通过 youzan.shop.get 或店铺后台查看)。默认 access_token 有效期 7 天;刷新 token 后,旧 token 还有 1 小时缓冲有效期。
### 调用步骤
1. 有赞云控制台创建自用型应用,记录 client_id、client_secret。
2. 调用本接口换取 access_token(响应 data.access_token),并保存 refresh_token/authority_id 用于续期。
3. 在控制台【类目能力】中申请业务接口权限(如交易、商品),审核通过后才能调用对应 API。
4. 业务调用路径格式:https://open.youzanyun.com/api/{api_name}/{api_version}?access_token=xxx。
### 响应
成功:{"success":true,"code":200,"data":{"access_token":"...","expires_in":604800,...}}。失败返回 success=false 与错误码,如 1000(client_secret 错误)、1103(client_id 不存在或授权关系不存在)。
### 生产建议
token 要集中缓存并提前刷新;如果 token 被人为刷新导致提前失效,需要重新触发授权流程,因此禁止多环境共用一份 token 互相覆盖。