系统接入说明
调用接口签需要先申请获取appid和securitykey(获取请联系商务),appid/securitykey属于应用私密数据,请妥善保管。
信签服务器采用标准HTTP协议对外提供服务。提供2类接口,API接口和页面接口。
- API接口:提供服务器端调用,接口地址以“/api”开头的接口地址,接口content-type为:application/x-www-form-urlencoded,如果接口存在上传文件,那么content-type为:multipart/form-data
- 页面接口:提供客户端浏览器调用,接口地址以“/action”开头的接口地址。
demo获取:目前提供java语言的demo示例代码,点此下载
API接口调用说明
调用所有以api开头的接口,需要先在http/https协议添加header方式传递appid和认证信息验证接口安全。添加方式如下:
在http的请求添加header参数,包括appid,time,sign 3个header参数
- appid:值为申请的appid
- time:值为当前系统的时间毫秒值。
- sign:将appid和time,securitykey,进行(appid+’.’+time+’.’+接入方密钥)拼接并计算MD5哈希算法后转换成16进制字符串。
java添加方式如下:
HttpURLConnection.setRequestProperty("appid",接入方编号);
HttpURLConnection.setRequestProperty("time",接口调用时间[毫秒值]);
HttpURLConnection.setRequestProperty("sign",MD5(appid+’.’+time+’.’+接入方密钥));
页面接口调用说明
调用所有以action开头的接口,需要将目标接口的所有参数调用api/common/generateToken,此接口将接收所有参数缓存,并返回token,token有效期为30分钟,并将获取的token做为参数拼接到目标接口访问,token一经访问使用,不能在其他电脑上使用。详细步骤如下:
1. 例如需要访问浏览器签署页面接口,按照实际需求添加参数如下:
此地址包括signer_code和biz_id 2个参数。
将上面地址的全部请求参数在服务器端请求/api/common/generateToken获取token。此接口对接参考“API接口调用说明”
此接口响应结果
属性 |
类型 |
说明 |
code |
string |
结果代码,1为成功,其他为失败,失败信息参考msg |
msg |
string |
结果信息 |
token |
string |
请求参数缓存的token |
2. 将上面返回的token值作为参数拼接到目标接口后,如上http://IP:PORT/tosignserver/action/contract/sign/1154213997654839296?token={token},然后在浏览器访问完成接口访问。
token一经访问,只能在当前电脑使用,不能在其他电脑或其他浏览器使用。