OpenAPI接入指南 | 您所在的位置:网站首页 › 银联商务统一平台app › OpenAPI接入指南 |
产品token是开放平台每个产品的全局唯一接口调用凭据,应用调用各接口时都需使用产品token,开发者需要进行妥善保存。产品token的存储至少要保留512个字符空间。产品token的有效期目前为2个小时,需定时刷新,重复获取将导致上次获取的产品token失效。 开放平台OpenAPI调用所需的产品token的使用及生成方式说明: (1)为了保密app_secrect,需要一个产品token获取和刷新的中控服务器。而其他业务逻辑服务器所使用的产品token均来自于该中控服务器,不应该各自去刷新,否则会造成产品token覆盖而影响业务; (2)目前产品token的有效期通过返回的expire_in来传达,目前是7200秒之内的值。中控服务器需要根据这个有效时间提前去刷新新产品token。 (3)平台现已提供全局token获取接口,地址为:https://openapi.unionpay.com/upapi/token 调用OpenAPI的应用使用app_id和app_secert调用对应产品的token接口来获取产品token。 app_id和app_secret可在开放平台“个人中心-API认证账号”(详见:接入指南)中获得(需要用户先登录开放平台)。 调用接口时,请提前将服务器IP地址添加到用户IP白名单中,否则将无法调用,返回应答码为9901(详见:全局返回码说明)。 接口调用说明 HTTPS请求方式:POST URL: https://openapi.unionpay.com/upapi/cardbin/token Content-Type: application/x-www-form-urlencoded body: app_id={APP_ID}&app_secret={APP_SECRET} 参数说明 中文名称英文名称域类型域长度默认值请求要求备注用户唯一凭证app_idstringM-必填详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看用户唯一凭证密钥app_secretstringM-必填详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看返回说明 正常情况下,开放平台会返回下述JSON数据包给调用方: {"token":"","expire_in":7200} 参数说明 中文名称英文名称域类型域长度默认值请求要求备注应答码respCdstring4M-必填应答消息respMsgstringM-必填产品tokentoken stringC-依条件必填获取到的凭证; 凭证是字符串过期时间expire_in intC-依条件必填凭证有效时间,单位:秒 |
CopyRight 2018-2019 实验室设备网 版权所有 |