《电子印章公共服务平台云端集中用印模式政务网、互联网、兼容标准自建用印模式接入接口定义及示例.docx》由会员分享,可在线阅读,更多相关《电子印章公共服务平台云端集中用印模式政务网、互联网、兼容标准自建用印模式接入接口定义及示例.docx(32页珍藏版)》请在优知文库上搜索。
1、附录A(规范性)云端集中用印模式政务网接入接口定义及示例A.1创建个人页面签署A.1.1接口说明接口协议:HTTPS协议。请求方式:POSToContent-Type:multipart/form-data;charset=UTF-8。接口地址:sync/create/personaloA.1.2请求消息请求消息说明见表A.1。表A.1名称类型是否必填描述fileFile是pdf/ofd文档(30M限制)titleString否电子文档名称PersonNameString是用户姓名contactString是联系方式,手机号cardnoString否身份证号,标识用户身份,尽量传入SealDa
2、taString否Base64印章数据(根据contact进行查询,若查询到印章数据则使用平台内印章,若没查询到印章数据则使用传入的SealData)StamperStrString否签署位置预设置,如:x:0.4JyjO.4,pageZ2needVerifyBoolean否是否需要校验身份,默认true,校验身份SuccessPageString否签署成功后的页面跳转地址(前端跳转地址)注意:需添加请求协议A.1.3签署位置参数(StamperStr)A.1.3.1根据坐标指定签署位置,参数说明见表A.2:表A.2名称类型是否必填描述XDouble是印章横坐标占比,左下角为原点(Ofd签署时
3、,左上角为原点)yDouble是印章纵坐标占比,左下角为原点(Ofd签署时,左上角为原点)pageDouble是印章签署所在页参数示例:(文件第一页,X占页宽0.4,Y占页高0.4处)x:0.4,V:0.4,page:1A.1.3.2根据关键字指定签署位置,参数说明见表A.3。表A.3名称类型是否必填描述keywordString是关键字offsetXDouble否关键字X坐标偏移量(占页宽比)offsetYDouble否关键字Y坐标偏移量(占页高比)keyIndexint否关键字索引(关键字在全文出现多次,选择出现的位置,默认1为第一次出现的位置,0为所有关键字出现的位置)参数示例:(全文搜
4、索关键字“甲方”,选取第二个“甲方”,并向左偏移页宽长度的0.1,向下偏移页高长度的0.1)。keyword:申万,“offsetX”:-0.1,“offsetY”:-0.1,“keylndcx”:2)创建多个签署位置参数示例。x:0.4,V:0.4,lpage:1),(keyword:申万,offsetX”:-0.1,offsetY”:-0.1,“keyindex”:2code”:O,/0:成功,其余失败documentId:2545462971542704132”,文档idmessage:SUCCESS”,成功失败信息签署页面地址)A.2创建印章页面签署A.2.1接口说明接口协议:HnPS
5、协议。请求方式:POSTeContent-Type:multipart/form-data;charset=UTF-8。接口地址:sync/create/company0A.2.2请求消息请求消息说明见表A.4o表A.4名称类型是否必填描述fileFile是PDF/OFD文档(30M限制)titleString否电子文档名称contactString是联系方式,手机号,用于签署时校验身份(使用零信任签署人工确认时校验方式为确认人手机号,可不传,确认人为Ukey时需要插入Ukey确认签署)StamperStrString否签署位置预设置,如:x”:0.4,/:0.4,page:2needVeri
6、fyBoolean否是否需要校验身份,默认IrUe,校验身份SuccessPageString否签署成功后的页面跳转地址(前端跳转地址)sealIdsString否服务端印章编号,可从门户系统获取印章编号,格式:1222222222,333333322222(注比:1、Ofd签署时,相应印章需要有对应国办印章2、使用零信任接口签署,系统确认,人工确认授权功能的时候,不支持传入多个不同的印章,且同步签署不支持使用人工确认方式的印章)SerialNumString否零信任接口签署系统权限校验流水号(与权限校验token同时传入)PermissionTokenString否零信任接II签署系统确认权
7、限校验tokenA.2.3签署位置参数(StamperStr)A.2.3.1根据坐标指定签署位置,参数说明见表A.5。表A.5名称类型是否必填描述XDouble是印章横坐标占比,左下角为原点(Ofd签署时,左上角为原点)yDouble是印章纵坐标占比,左下角为原点(Ofd签署时,左上角为原点)pageDouble是印章签署所在页参数示例:(文件第一页,X占页宽0.4,Y占页高0.4处)x:0.4,V:0.4,page:1A.2.3.2根据关键字指定签署位置,参数说明见表A.6。表A.6名称类型是否必填描述keywordString是关键字offsetXDouble否关键字X坐标偏移量(占页宽比
8、)offsetYDouble否关键字Y坐标偏移量(占页高比)keyIndexint否关键字索引(关键字在全文出现多次,选择出现的位置,默认1为第一次出现的位置,0为所有关键字出现的位置)参数示例:(全文搜索关键字“甲方”,选取第二个“甲方”,并向左偏移页宽长度的0.1,向下偏移页高长度的0.1)keyword:甲方,“offsetX”:-0.1,“offsetY”:-0.1,“keyindex”:2)创建多个签署位置参数示例:x:0.4,V:0.4,page:1),(keyword:申万,offsetX”:-0.1,“offsetY”:-0.1,“kcylndex”:2A.2.4响应消息(co
9、de:0,/0:成功,其余失败documentId:2545462971542704132”,文档idmessage:SUCCESS”,成功失败信息签署页面地址)A.3创建ukey页面签署A.3.1接口说明接口协议:HnPS协议。请求方式:POST0Content-Type:multipart/form-data;charsct=UTF-8。接口地址:sync/create/ukey(A.3.2请求消息请求消息说明见表A.7。表A.7名称类型是否必填描述fileFile是PDF/OFD文档(30M限制)titleString否电子文档名称StamperStrString否签署位置预设置,如:x
10、:0.4,y”:0.4,pageSuccessPageString否签署成功后的页面跳转地址(前端跳转地址)A.3.3签署位置参数StamPerStrA.3.3.1根据坐标指定签署位置,参数说明见表A.8。表A.8名称类型是否必填描述XDouble是印章横坐标占比,左下角为原点(Ofd签署时,左上角为原点)yDouble是印章纵坐标占比,左下角为原点(Ofd签署时,左上角为原点)pageDouble是印章签署所在页参数示例:(文件第一页,X占页宽04,Y占页高0.4处)(x”:0.4,V:0.4,A.3.3.2根据关键字指定签署位置,参数说明见表A.9。表A.9名称类型是否必填描述keywor
11、dString是关键字offsetXDouble否关键字X坐标偏移量(占页宽比)OffsetYDouble否关键字Y坐标偏移量(占页高比)keyIndexint否关键字索引(关键字在全文出现多次,选择出现的位置,默认1为第一次出现的位置,0为所有关键字出现的位置)参数示例:(全文搜索关键字“甲方”,选取第二个“甲方”,并向左偏移页宽长度的0.1,向下偏移页高长度的0.1)keyword:申万,offsetX”:-0.1,offsetY”:-0.1,“keyindex”:2U创建多个签署位置参数示例x:0.4,V:0.4,page:1),(keyword:申万,offsetX”:-0.1,off
12、setY”:-0.1,“keyindex”:2)A.3.4响应消息(code:0,/0:成功,其余失败documentId:2545462971542704132”,文档id“message:SUCCESS”,/成功失败信息签署页面地址A.4创建个人静默签署接口协议:HnPS协议。请求方式:POST0Content-Type:multipart/form-data;charset=UTF-8接口地址:synccreatepersonalautosign,A.4.2请求消息请求消息说明见表A.10。表A.10名称类型是否必填描述fileFile是pdf/ofd文档(30M限制)titleStri
13、ng否电子文档名称PersonNameString是用户姓名contactString是联系方式,手机号cardnoString否身份证号,标识用户身份,尽量传入SealDataString否Base64印章数据(根据ContaCt进行查询,若查询到印章数据则使用平台内印章,若没查询到印章数据则使用传入的sealData)StamperStrString是签署位置预设置,如:*x0.4,V:0.4,*page*:2A.4.3签署位置参数StanlPerStrA.4.3.1根据坐标指定签署位置,参数说明见表A.11。表A.11名称类型是否必填描述XDouble是印章横坐标占比,左下角为原点(Ofd签署时,左上角为原点)yDouble是印章纵坐标占比,左下角为原点(Ofd签署时:左上角为原点)pageDouble是印章签署所在页参数示例:(文件第一页,X占页宽0.4,Y占页高0.4处)x:0.4,V:0.4,page:1)A.4.3.2根据关键字指定签署位置,参数说明见A.12。名称类型是否必填描述keywordString是关键字