文档

平台简介

1. 商户系统使用分配的APP_ID和APP_KEY访问顺丰开放平台获取ACCESS_TOKEN

2. 顺丰系统发现该请求时合法请求,调用商户预留在商户管理系统里的回调地址并在参数中返回颁发的
    ACCESS_TOKEN和REFRESH_TOKEN

3. 商户系统获取到颁发的ACCESS_TOKEN和REFRESH_TOKEN后保存该ACCESS_TOKEN和REFRESH_TOKEN
    并在后续调用顺丰开放平台的接口中使用附带该ACCESS_TOKEN进行交互

    注:如您无法提供回调地址服务,可以在申请完接入令牌后,使用APPID和APPKEY进行申请令牌的查询,服务如下:
    https://{domain}/public/v1.0/security/access_token/query/sf_appid/{sf_appid}/sf_appkey/{sf_appkey}
    沙盒测试环境{domain}:open-sbox.sf-express.com    生产环境{domain}:open-prod.sf-express.com

4. 顺丰开放平台发现ACCESS_TOKEN合法后,完成商户指定接口请求,并返回商户请求响应。


5. 如果商户系统发现已颁布的ACCESS_TOKEN访问提示“请求令牌过期”,商户系统可以再次发起刷新令牌
    的请求新的ACCESS_TOKEN

a. 商户使用REFRESH_TOKEN去调用顺丰REFRESH_TOKEN接口

b. 顺丰OPENAPI检查REFRESH_TOKEN有效性,如果有效并重置ACCESS_TOKEN的状态为有效

c. 商户继续使用ACCESS_TOKEN,并在后续调用顺丰开放平台的接口中使用附带该ACCESS_TOKEN进行交互

d. REFRESH_TOKEN的有效时间为一个自然日,如果超过时效,需要重新申请接入令牌,并会重新生成新的REFRESH_TOKEN。