首页 > 文档中心 > 开发指南 > H5接入规范

H5接入规范

支持通过业务ID调用开放银行API的方式，获取到兴业银行H5的URL，然后打开该URL进入到对应的业务功能页面。

交互示例图

h5接入交互示例图

通讯方式

通讯方式	HTTP/HTTPS协议
请求方式	POST（FORM）
请求Url	/api/web/token/genToken
签名	参照【API接入规范】

输入参数

输入参数说明

序号	参数名	参数格式	是否必输	参数位置	参数描述
1	bizId	String	Y	Body	业务ID（每个本行业务入口H5应用的URL对应一个业务ID）
2	suffix	String	N	Body	URL后缀参数（暂不支持）
3	param	String	Y	Body	业务参数

输入示例


Map bodyParams = new HashMap();
bodyParams.put("bizId", "qwsd_pay");
bodyParams.put("param", "{\"version\":\"2.0\",\"mch_id\":\"12132ewqe\"}");
String response = OpenSdk.gatewayWithKeyId("/api/web/token/genToken", ReqMethodEnum.POST, null, null, bodyParams, keyId);

响应参数

输出参数说明

序号	参数名	参数格式	是否必输	参数位置	参数描述
1	bizId	String	Y	Body	业务ID
2	url	String	Y	Body	处理后的URL地址(带有token信息，URL编码)
3	expire_type	number	Y	Body	链接有效性策略:0-（有效期内）单次有效; 1-（有效期内）多次有效;
4	expire_time	number	Y	Body	链接有效期，单位为秒

输出示例


{
  "msg": "成功",
  "expireTime": null,
  "code": "0000",
  "expireType": 0,
  "bizId": "qywx_xzh",
  "url": "https://baidu.com332?bizId=qywx_xzh&token=1B9102E51FAD4E30B05E3BB44D6418A868B2D5356F8467E4CFE8BB1398899B244F6CA3D671A84D97B7240F7AF55C09C0",
  "status": "SUCCESS"
}