# 全国企业采购交易寻源询价系统开放平台接入指南
# 接入前置条件
接入方需要向全国企业采购交易寻源询价系统开放平台(以下简称平台)申请权限,所有接口权限都需要单独开通。平台方会提供 AppKey、AppSecret 等信息。此 AppKey 将视为三方系统在平台上的唯一身份认证。
# 开通权限需要提供的资料
资料名称 | 备注 |
---|---|
公司名称 | - |
IP白名单 | 调用平台接口的服务器IP列表 |
对接业务 | 会根据业务开通 API 权限 |
业务系统接入资料 | 根据业务不同需要提供,详见业务系统接入资料 |
# 业务系统接入资料
业务系统 | 资料说明 |
---|---|
用户中心 | 平台在某些业务场景会向三方系统推送相应数据。 |
退出登录推送:https://www.xxx.com/logout (需要pushToken,见:推送服务) | |
用户信息变更推送:https://www.xxx.com/user/update (需要pushToken,见:推送服务) | |
登录成功回调地址:https://www.xxx.com/callback |
# 接口调用说明
除非接口有特殊说明,否则请求平台所有接口均需在 Header 中携带 accessToken 参数。 accessToken 具体获取规则详见获取 API 接口 accessToken
accessToken: leyJhbGciOiJIUzI1NiJ9.eyJhcHBrZXkiOiIwLXh5eGoiLCJhY2Nlc3NUb2tlbklkIjoiYTNjM2ZlZmJjYWI1NGJmMmE4MDliYmQ3YjAxNjU0ZmEiLCJpYXQiOjE2NTY5NDI5MzEsImV4cCI6MTY1Njk1MDEzMX0.Ht65S_mt5wQLyOWEXE-42BVQVczckSD3flZnCQhm_wk
# 推送服务
如需平台向三方系统推送某业务场景数据,需向平台申请 pushToken,此 pushToken 将用来做签名校验,不参与任何业务
# 环境说明
# 注: 所有环境请求都需要使用HTTPS协议
开放平台生产环境接口域名 zapi.cneptp.com
开放平台测试环境接口域名 dev-zapi.cneptp.com
以 获取 API 接口 accessToken 接口为例, 实际接口请求地址如下:
开放平台生产环境接口请求地址为: https://zapi.cneptp.com/openapi/token
开放平台测试环境接口请求地址为: https://dev-zapi.cneptp.com/openapi/token