| 开发者中心

系统接入说明

调用接口签需要先申请获取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. 例如需要访问浏览器签署页面接口,按照实际需求添加参数如下:
http://IP:PORT/tosignserver/action/contract/sign/1154213997654839296?signer_code=xurong&biz_id=test
此地址包括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一经访问,只能在当前电脑使用,不能在其他电脑或其他浏览器使用。