电子印章公共服务平台云端集中用印模式政务网、互联网、兼容标准自建用印模式接入接口定义及示例.docx
附录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否身份证号，标识用户身份，尽量传入SealDataString否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签署时，左上角为原点）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为所有关键字出现的位置）参数示例：（全文搜索关键字“甲方”，选取第二个“甲方”，并向左偏移页宽长度的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”:2"code”:O,/0：成功，其余失败"documentId":"2545462971542704132”,文档id"message":"SUCCESS”,成功失败信息签署页面地址）A.2创建印章页面签署A.2.1接口说明接口协议：HnPS协议。请求方式：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":2needVerifyBoolean否是否需要校验身份，默认IrUe,校验身份SuccessPageString否签署成功后的页面跳转地址（前端跳转地址）sealIdsString否服务端印章编号，可从门户系统获取印章编号，格式：1222222222,333333322222（注比:1、Ofd签署时,相应印章需要有对应国办印章2、使用零信任接口签署，系统确认，人工确认授权功能的时候,不支持传入多个不同的印章，且同步签署不支持使用人工确认方式的印章）SerialNumString否零信任接口签署系统权限校验流水号（与权限校验token同时传入）PermissionTokenString否零信任接II签署系统确认权限校验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坐标偏移量（占页宽比）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响应消息（"code":0,/0：成功，其余失败"documentId":"2545462971542704132”,文档id"message":"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":0.4,"y”:0.4,"page"SuccessPageString否签署成功后的页面跳转地址（前端跳转地址）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名称类型是否必填描述keywordString是关键字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,"offsetY”:-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限制）titleString否电子文档名称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是关键字
