认证与网关参数(鉴权方式:OAuth2 accessToken,自动获取)
accessToken 管理(OAuth2 获取,有效期 2 小时自动刷新)
说明:发送接入请求时若 token 缺失或临期(剩 120 秒内)将自动重新获取;2 小时内重复获取返回同一 token。
接口编码(serviceCode 按环境)
| 接口 | method | 测试环境 serviceCode | 生产环境 serviceCode | 本地接收地址(pushTask) |
接出接口地址(提供给顺丰作为推送回调)
| 环境 | 推送地址 |
| 测试 | POST /api/openapi/csapi |
| 生产 | POST /api/openapi/scapi |
完整回调地址 = 部署域名/端口 + 上述路径,例如 https://your-domain:8080/api/openapi/csapi(端口由环境变量 PORT 决定,默认 8080)。顺丰按接出规范推送:header 含 appid/timestamp/sign(条件)/method,body 为 data(JsonString)。本网关校验 appid 与 sign。
模拟顺丰推送
接口请求/返回日志(log.txt 持久化)