GMT 0131-2023 电子签章应用接口规范

电子签章应用接口规范国家密码管理局发布I Ⅲ 1 1 14缩略语 2 2 25.2服务调用接口 45.3组件调用接口 4 46.1基础接口 46.2综合接口 7组件调用接口 217.1基础接口 7.2综合接口 28 附录B(规范性)自定义C语言数据结构 附录C(资料性)典型服务调用接口示例 附录D(资料性)典型组件调用接口示例 附录E(规范性)错误代码定义 ⅢGB/T20518信息安全技术公钥基础设施数字证书格式GB/T20520信息安全技术公钥基础设施时间戳规范GB/T32010.1文献管理可移植文档格式第1部分：PDF1.7电子文件存储与交换格式版式文档2签章服务electronicsealsignatureservice提供支持OFD和PDF等格式的数字电文的电子印章签署服务。电子签章系统electronicsealsignaturesystem对数据电文提供电子签章、数字签名、签名验证等服务的软件系统。分散式签章decentralizedeleetronicsealsignature在电子印章所有者掌控的密码模块中实现电子印章私钥的存储及具计算。集中式签章centralizedelectronicsealsignature电子印章私钥统一存储在指定的密码设备中，该密码设备由电子签章系统掌控。电子印章使用者通过电子签章系统实现对电子印章的使用。用户在电子签章系统重被度权的电子印用户证书usercertilicate用户在电子签章系统里被段权的数字证B/S模式browser/serrerzmode客户端统一为WEB浏览器，系统功能实现的核心部分集市到服务器工的一种应用系统模式。4缩略语下列缩略语适用于本文件DER:可辨别编码规则(DistinguishedEncodiHTTP:超文本传输协议(HIyperTextTransfer-Protocol)OFD:开放式版式文档(OpenFixedlayoutDocument)OID:对象标识符(ObjectID)PDF:可移植文档格式(PortableDocumentFormat)PKI:公钥基础设施(PublicKeyInfrastructure)SDK:软件开发工具包(SoftwareDevelopmentKit)5电子签章应用接口概述5.1通用要求本文件在GM/T0094—2020中第4章的公钥密码应用技术体系框架中的位置见图1。3应用1～应用应用1～应用N基础设电子签章应用接口包括服务调用接口和组件调用接口两种接口形式。服务调用可采用HTTP或HTTPS服务。组件调用可采用部署在用户端的DLL/SO等SDK组件。这两种接口形式分别包含基础应用接口和综合应用接口，支持分散式签章和集中式签章两种模式。电子签章应用接口列表如表1接口名接口1获取签章服务信息2345678SEF_AddTimestampToSi9获取错误信息接口1文件定位签章2文件关键字签章3文件加盖骑缝章4文件数字签名54表1电子签章应用接口列表(续)接口名接口6789文件签章/签名验证，验证所有签章和签名本文件所涉及的OED文件应衔合GB/T33190和GM/T0099的规定，PDF文件应符合电子签章的签名算法应与电子印章的签名算法一致，如果签名算法是SM2,则电子印章结构、电子签章结构应符合GB/T38540或GM/T0031的规定，签名值应符合GB/T35275的规定，电子印章和电子签章数据结构的数字证书应符合GB/T20518的规定。当杂凑算法使用SM3时，杂凑值应符合所有涉及电子印章私钥腺作的接日应及施私钥验流安全桃制。智能密码钥匙私钥操作应符合GB/T35291的规定，密码设备私钥操佰应符合GB/T36322-的肌症。服务端狭取用户印章信息列表和服务端获取用户证书信息列是的接的应进行身份。用户身份率列流程可参考文献[1][2][3]。自定义JsON报文数服结构应符合附的规定义C语言数据结构应符合附录B的规定，典型服务调用接口示例见附C,典型调用接示例见附录D误代码定义应符合附录E的规定。智能鳖码钥匙操作应符否GE/工33291的规定，密码设备操作应符合GBZT36222的规定。5.2服务调用接口服务调用接口为请求/响应服务的形式，可用于B/S模式的应用系统。客庐端通过网络数据报文方式发送请求数据，并接收服务端的响应数据报文。请求数据和响应数据采角JsON报文数据格式封装，JSON数据中的二进制数据应进行Base64编码，编码方式应符合RFC4648中第4章的规定。String类型的数据除非特别说明。默认使用UTF-8编码。5.3组件调用接口组件调用接口由电子签章系统通过SDK组件的方式为应用系统提供本地化的接口调用。SDK组件直接部署在应用系统中，采用本地化接口调用方式提供服务。组件接口中int类型大小为32比特。6服务调用接口6.1基础接口5是是与resultCode对应的文字说明(UTF-8编码)是是是否是时间值，为当前时间的毫秒数，用于超时校验否否用，适用于集中式签章是是认证类型，0:无认证；1:token认证否6是是与resultCode对应的文字说明(UTF-8编码)是是时间值，为当前时间的毫秒数，用于超时校验否印章名称否印章ID是印章状态，0:所有；1:有效；2:无效；3:冻结是是与rcsultCode对应的文字说明(UTF-8编码)是印章数据信息列表，对应印章数据信息JSON报文结构定功能描述：获取用户证书信息列表。分散式用章枚举智能密码钥匙里的数字证书，集中式用章只能获取指定的用户证书。本接口只获取对应的签名证书，数字证书格式符合7是时间值，为当前时间的毫秒数，用于超时校验否否用，适用于集中式签章是是认证类型，0:无认证；1:token认证是认证类型，0:无认证；1:token认证是是与resuliCode对应的文字说明(UTF-8编码)是用户数字证书列表，对应的用户证书信息JSON报文结构定义应符合表A.3的规定6.1.5根据证书ID获取数字证书是时间值，为当前时间的毫秒数，用于超时校验是是8是是与resultCode对应的文字说明(UTF-8编码)是Base64编码证书数据，如果数字证书签名算法使用是是ID数据是是与resultCode对应的文字说明(UTF-8编码)是杂凑算法标识的OID,应符合GB/T33560的规定是签名算法标识的OID,应符合GB/T39表13封装签章结构的请求参数是时间值，为当前时间的毫秒数，用于超时校验否否用，适用于集中式签章是印章标识否是是认证类型，0:无认证；1:token认证否响应参数：封装签章结构的JSON格式响应参数见表14。表14封装签章结构的响应参数是是与resultCode对应的文字说明(UTF-8编码)是Basc64编码的签章数据结构，如果签名算法使用S符合GB/T38540的规定6.1.8添加时间戳到签章结构体功能描述：把时间戳封装到签章结构体中，签章结构体应符合GB/T38540的规定，时间戳数据应符合GB/T20520的规定。接口地址：HTTP(S)://SERVER:PORT/SEF/V1/SEF_AddTimest请求参数：添加时间戳到签章结构体的JSON格式请求参数见表15。表15添加时间戳到签章结构体请求参数是时间值，为当前时间的毫秒数，用于超时校验是Base64编码的签章结构(不带时间戳)是Base64编码的时间戳，应符合GB/T20520表16添加时间戳到签章结构体响应参数是是与resultCode对应的文字说明(UTF-8编码)是Base64编码的带时间戳的签章结构，如果签功能描述：调用户印章私钏进行数字签名，封装不含时间戳的消息签名数据，如果签名算法是SM2,消息签名数据应符合GB/T35275—2017中第8章规定的签名数据类型。调用方式HTTPPOST(JSON)表1二封装消息签名结构的请求参数型是而时间为当前时间的皂秒数，用于超时校验用D⁴分散式用章时过为零集中式用章时不能为空正书序列号是Basc64编码的签章保护原文数据的杂倭值(不带ID)是原文杂凑算法OID,应符合GB/T33560的规定是认证类型，0:无认证；1:token伙证；否表18封装消息签名结构的响应参数是是与resultCode对应的文字说明(UTF-8编码)是Base64编码的消息签名数据，如果使用SM2算法验证流程进行验证；消息签名数据应按照GB/T35275的规定对消息签名格式进行是时间值，为当前时间的毫秒数，用于超时校验是是是签章或者签名格式类型，0:未知；1:GB/T38540;2:GB/T35275;3:GM/T0031;4:pkc是是与resultCode对应的文字说明(UTF-8编码)是时间值，为当前时间的毫秒数，用于超时校验是是表22解析签章数据的响应参数是是与resultCode对应的文字说明(UTF-8编码)是请求参数解析印章数据的JSON格式请求参数见表23。表23解析明章数据请求参数头型SBasa码印章数据，如果印章签名算法合GB38540或者GM/T0031的规定是表24解析印章数据响应参数是与jresnhCode对应的文字说明(UTF-8编码)印章数据结构，对应印章信息JSON报文结构应符合表是时间值，是UTF-8编码的文件名是数据电文类型是Base64编码待签章数据电文或者UTF-8编码是是否锁定文件；式锁定否否用，适用于集中式签章是返回数据类型，positionScalSignIn-是文结构应符合表A.6的规定是否是是与resultCode对应的文字说明(UTF-8编码)是是Base64编码的输出数据电文流，或者UTF-8编码的输出数据地址，具体根据入参outFileDataType确定表27文件关键字签章请求参数是时间，为当前时间的毫秒数。该时间用于超时校验，不要用做签章时间是UTF-8编码的文件名是是Base64编码待签章数据电文或者UTF-8编码是否否用，适用于集中式签章是返回数据类型，keyWordScalSignIn-是关键字签章的印章信息列表，对应关键字签章印章信息是否表28文件关键字签章响应参数是是与resultCode对应的文字说明(UTF-8编码)是返回数据类型，是Base64编码的输出数据电文流，或者UTF-8编码的输出数据地址，具体根据入参outFileDataType确定是验，不要用做签章时间是UTF-8编码的文件名是是Basc64编码待签章数据电文或者UTF-8编码是式锁定否用户ID,否外部应用ID,可区分不同外部应用，适用于服务器签章是是符合表A.8的规定是否认证值数据；表30文件加盖骑缝章响应参数是是与resultCode对应的文字说明(UTF-8编码)是返回数据类型，是Base64编码的输出数据电文流，或者UTF-8编码的输出数据地址，具体根据入参outFileDataType确定据应符合GB/T35275—2017中第8章规定的签名数据类型。表31文件数字签名请求参数是时间值，为当前时间的毫秒数，用于超时校验是UTF-8编码的文件名是是Base64编码待签章数据电文或者UTF-8编码是是否锁定文件，定文档，第二个锁定文档否否外部应用ID,可区分不同外部应用，适用于服务器签章是是是否是是与resultCode对应的文字说明(UTF-8编码)是返回数据类型，是Base64编码的输出数据电文流，或者UTF-8编码的输出数据地址，具体根据入参outFileDataType确定是时间值，为当前时间的毫秒数，用于超时校验是UTF-8编码的文件名是是Basc64编码待签章数据电文或者UTF-8编码是是符合表A.9的规定是是与resultCode对应的文字说明(UTF-8编码)是返回数据类型，是Base64编码的输出数据电文流，或者UTF-8编码的输出数据地址，具体根据入参outFileDataType确定是UTF-8编码的文件名是数据电文类型，是Base64编码待签章数据电文或者UTF-8编码表36文件签章验证的响应参数参数名称类型是森塑与rsshCode对的的文字说明(UTF-8编码)FileVcdy行诺表五正的规定是时间值，是UTF-8编码的文件名是数据电文类型，是Base64编码待签章数据电文或者UTF-8编码是是与rcsultCode对应的文字说明(UTF-8编码)是对应文件验证结果JSON报文结构应符合表39获取文件签章/签名个数请求参数是时间值，为当前时间的毫秒数，用于超时校验是UTF-8编码的文件名是是Base64编码待签章数据电文或者UTF-8编码表40获取文件签章/签名个数响应参数是是与resultCode对应的文字说明(UTF-8编码)是是时间值，为当前时间的毫秒数，用于超时校验是是是Basc64编码待签章数据电文或者UTF-8编码签章/签名索引是是括签消息签验结果一对应签章消息签名验证结果JSO脆文结构应符合表A.直的规定是时间值是UTF-8编码的文件名是是Base64编码待签章数据电文或者UTF-8编码是图像类型，支持“PNG”“JPG”“BMP”是是起始页索引，0为首页是是是与resultCode对应的文字说明(UTF-8编码)是页面图像信息列表，对应页面图像信息JSON报文结构应符合表A.12的规定是时间值，为当前时间的毫秒数，用于超时校验是UTF-8编码的文件名是是Base64编码待签章数据电文或者UTF-8编码的是是与resultCode对应的文字说明(UTF-8编码)是char*pchProviderCompany,int*piProvidechar*pchProviderVersion,int*piProvidechar*pchExtendParam,int*piExtpchProviderName[in/opchProviderCompany[in/opiProviderCompanyLen[in/opchProviderVersion[in/opiProviderVersionLen[in/o签章服务名称(UTF-8编码),当为NULL签章服务版本(UTF-8编码),当为NULLintSEF_GetUserScalInfoList(constintiRequestTime,constpchUserID,constchar*pchSiteconstunsignedchar*puchUSERSEALINFO*pUserSealInfoList,int*piUserScalInfoLi用户ID,分散式用章时可为NULL,如果是集intSEF_QueryScalsByNamconstchar*pchScalID,constchar*pchScalNamc,constSEALDATAINFO*pScalDataInfoList,int*pipScalDataInfoList[in/opScalDataInfoList[in/o印章数据信息列表，当为NULL时，通过intSEF_GetUserCertInfoList(constintiRequestTime,constpchUserID,constchar*pchSiteconstunsignedchar*puchUSERCERTINFO*pUscrCertInfoList,int*piUserCertInfoL用户ID,分散式用章时可为NULL,如果是集pUserCertInfoList[in/o用户证书信息列表，当为NULL时，通过intSEF_GetCertByCeconstintiStatus,unsignedchar*pchDigestAlgOID,int*piDigechar*pchSignAlgOID,int*piSigpuchDigestAlgOID[in/o型为1时表示证书ID杂凑算法标识的OID,应符合GB/T33560的piDigestAlgOIDLen[in/opuchSignAlgOID[in/ou签名算法标识的OID,应符合GB/T33560piDigestAlgOIDLen[in/opuchSignAlgOID[in/oupiSignAlgOIDLen[in/ointSEF_PackSignedVaconstchar*pchSitcID,constconstchar*pchPropertyInfo,constunsignedconstintiDataHashLenconstunsignedchar*puchunsignedchar*puchScalSignedValuc,int*piScalSignedValucLen);用户ID,分散式用章时可为NULL,如果是集用SM2,应符合GB/T38540的规定，当为NULL时，通过piScalSignedValucLen给出intSEF_AddTimestampToScalSignedValue(constintiRequestTimc,constunsignedchar*puchScalSigncdValuc,constintiScalSignedValucLen,constunsignedchar*puchTimcstamp,constint*iTimestampLen,unsignedchar*puchOutScalSignedValuc,int*piOutScalSignedValucLen);puchSealSignedValuc[DER编码的时间戳，应符合GB/T20520的puchOutScalSignedVaNULL时，通过piOutScalSignedpiOutScalSignedValue错误码*intSEF_PackSignedMessage(constintiR*pchUserID,constchar*pchSiteID,constchar*pchCentSN,constchar*pchDigestAlgOID,consiintiDataHashlcconstunsigncdchanCpuchuibVahue,conSImt息签名数应符合G5275戮的消息签名数如果签名算法是SM2,消外部应用D,当有多个外部应用时可区分不同原文杂凑算法OID应符合GB/T33560的认证类型当为NULL时，通过piSignedMessageLen给函数原型intSEF_VcrifySignedDatDataHash,constintiDataHashLen,constintiSignStructType,unsignedchar*puchSignedData,int*piSignedDataLen);功能描述验证电子签章/签名数据，对于签章数据，按照GB/T38540—2020中7.3或者GM/T0031—2014中6.2.3的电子签章验证流程进行验证；对于签名数据，按照GB/T35275—2017中第8章签名数据类型格式进行验证。puchDataHash[in]印章保护原文的hash值iDataHashLen[in]puchSignedData[in]DER编码的签章/签名数据结构体piSignedDataLen[in]签章参数chSignedValuc,constintpSignedValucLen,constintiVersion,SIGNEDVALUEINFO*pSignedValueInfo,int*piS38540和GM/T0031规定的电子签章数据。SigncdValucInfoLcn给出长度，签章信息数据结构定义应符合B.5的规定参数intSEF_GetScalInfo(constintiRconstunsignedchar*puchScalData,constintiScalDataSEALINFO*pSealInfo,in章人证书等信息。至少应支持GB/T385DER编码的印章数据结构体印章数据结构体长度印章数据版本印章信息数据结构体，当为NULL时，通过piSealInfoLen给出长度，印章数据结构定义应符合B.6的规定印章数据结构体长度返回值成功函数原型intSeF_GetEmMessage(cons功能描述根据错误代码获取错误信息。参数iErrCode[in]调用上一次接口返问的错误代码puchErrMessage[in/outlUTF-8编码的错误信息，当为piEnMessageLen给出长度返回值SEF_SuC(ESS成功7.2综合接口函数原型intSEESeaSignByPosfon(consRequcsTmconstcharXpchPdleNanic,ecistmTleLconstunsignedchar*puchFileDala,constintconsPOSITIONSEALSIGNINFO*pPositionSealSgnIeonstiniPositionSealSignInfoListLen,conconstunsignedchar*puchconstintiOutFileDaunsignedchar*puchOutFileData,inb功能描述根据签章位置参数对文件进行签章，其中印章及印章的位置由调用方设定，坐标以左上角为原点，坐标值宜采用比率，即坐标位置与整个页面高度/宽度的百分比。pchFileNamc[in7UTF-8编码的文件名2:签章后再添加消息签名方式锁定。puchFileData[in]文件二进制数据流或者UTF-8编码的数据地iFileDataLen[in]数据电文长度返回值pPositionScalSignInfoList[iPositionScalSignInfoListiOutFileDatatPype[用户ID,分散式用章时可为NULL,如果是集外部应用ID,当有多个外部应用时可区分不同外部应用，适用于集中式签章定位签章印章信息列表，定位签章印章信息数据结构定义应符合B.7的规定定位签章印章信息列表数组个数认证类型，认证数据认证数据长度需长度成功函数原型intSEFScaSgnQnKcyoras(coconstcharX(pchUserHD),consconstKEYWORDSEALSIGNINFO*pKcyWordSealSconstintiKeyWordScalInfoListLcn,consticonstumsignedchar*puchAuthValue,constintiAutbValucLen,unsignedchar*puchOutFileData,int*piOutFileDauaLen);功能描述给定关键字，加盖印章到关键字所在位置。当有多个关键字时，可指定加盖第几个关键字，默认加盖所有关键字参数iRequestTime[in]时间值，为当前时间的毫pchFileNamc[in]UTF-8编码的文件名iFileLock[in]是否锁定文件；0:不锁定；1:签章方式锁定；2:签章后再添加消息签名方式锁定。puchFilcData[in]文件二进制数据流或者UTF-8编码的数据地iFileDataLen[in]数据电文长度pchUscrID[in]用户ID,分散式用章时可为NULL,如果是集pKeyWordScalSignInfoList[puchOutFileData[in/opiOutFileDataLen[in/o返回值成功函数原型intSEF_SealSignOnCrosspages(constintiRequestTime,constunsignedchar*pconstPAGECROSSSEALSIGNINFO*pPageCrossScalInfoList,constintiPageCrossScalInfoListLen,constintiAutconstunsigncdchar*puchunsignedchar*puchOutFileData,intpchUserID[in]用户ID,分散式用章时可为NULL,如果是集返回值pPagcCrossScalSignInfoList[iPagcCrossSealSignIiOutFileDataLcn[in/out]骑缝签章印章信息列表，骑缝章印章信息数据结构定义应符合B.9的规定骑缝签章印章信息列表数据长度认证类型，0:无认证；1:token认证；2:签名值认证数据长度出数据地址，具体根据入参iOutFilcDataTyp出长度输出数据长度成功错误码7.2.4文件添加消息签名函数原型功能描述参数intSEFCotSn(cconstinjlcLock,consFiconstmnugacdchaconstchachUserIstconstinAnyp对文佳添加消息签名，义作可以被锁定签名，也可以不被锁定签名。如果使用SM2,消息签名数据应符合GB/T35275—2017中第8章规定的签名数据类型。UTF-8编码的文件名文件二进制数据流或者UTF-8编码的数据地数据电文长度用户ID,分散式用章时可为NULL,如果是集外部应用ID,当有多个外部应用时可区分不同外部应用，适用于集中式签章证书ID认证类型，0:无认证；1:token认证；2:签名值认证数据认证数据长度puchOutFileData[in/opiOutFileDataLen[in/ointSEF_AddAnnot(constconstintiFileDataType,constunsignedcconstintiFileDataLen,constANNOTDATAINFO*pAnnotDataInfoList,constintiAnnotDataInfoListLen,constintiOutFileDataType,unsignedchar*puchOutFileData,int*piOutFileDpAnnotDataInfoList[puchOutFileData[in/opiOutFilcDataLen[in/constchar*pchFileName,constconstunsignedchar*puchFileData,constintiFiFILEVERIFYINFO*pFileVerifyInfo,int*piFileVerifypFileVerifyInfo[in/oconstchar*pchFileName,constconstunsignedchar*puchFilcData,constFILEVERIFYINFO*pFileVerifyInfo,int*piFileVerifyInfoLen);pFileVerifyInfo[in/opiFileVcrifyInfoLen[in/oconstintiFileDataType,constunsignedchar*pucconstchar*pchFileName,constconstunsignedchar*puchFileData,constintiVERIFYSIGNINFO*pVerifySignInfo,int*piVerifySignInpVerifySignInfo[in/oupiVerifySignInfoLen[in/o为NULL时，通过piVerifySignInfoLen给出intSEF_FileToImage(coconstintiFileDataType,constunsignedchar*pucPAGEIMAGEINFO*pPageImageInfoList,int*piPageImageInfpPagclmagcInfoList[in/opiPageImageInfoListpiPagcImageInfoListLen给出长度intSEF_VerifySignedFile(constintiRequestTime,constconstintiFilcDataTypc,Lcn,FILEVERIFYINFO*pFileVerifyInfo,int*piFileVeripFileVerifyInfo[in/opiFileVerifyInfoLen[in/o文件二进制数据流或者UTF-8编码的数据地错误码用户印章信息JSON报文结构见表A.1。自定义类型是印章ID是是是印章版本表A.2印章数据信息JSON报文结构白定义类型是是印章当前状态是印章版本用户证书信息JSON报文结构见表A.3。白定义类型是是是签章信息JSON报文结构见表A.4。自定义类型是是是是否是Basc64编码的签章人证书，如果签名使用SM2算法，应符合GB/F20518的规定是S否Basc₆4编码的时间截，应符合GB/T20520的自定义类型型印章标，对应GB/T38540的csID是印章版本是是印章类型是UTT-8编码的印章名称是:证书；2:证书杂凑值是是是是是表A.5印章信息JSON报文结构(续)自定义类型是签名算法OID标识，是是印章图像类型，支持“PNG”“BMP”“JPG”是印章图像的高度，单位毫米是印章图像的宽度，单位毫米A.6定位签章印章信息JSON报文结构定位签章印章信息JSON报文结构见表A.6。自定义类型是印章标识是文件页码，页码计数从0开始是是印模左上角对应的x坐标与页面宽度的比率是印模左上角对应的y坐标与页面高度的比率关键字签章印章信息JSON报文结构见表A.7。自定义类型是是印章ID是骑缝章印章信息JSON报文结构见表A.8。自定义类型是1:盖；0:不盖是印章标识否否章左上角对应的x坐标与页面宽度的比率，manSeal为1时必选否是是率企验缝章印模图片所能覆盖的页数(-1默A.9注释数据信息JSON报文结构白定义类型参数名称是明度50%;1:普通注释。添加到指定页面指定位置，不透明是注释数据类型，0;纹文字；1:图片是dataType=0是表示文字注释数据，UTF-8否否印模左上角对应的x坐标与页面宽度的比否印模左上角对应的y坐标与页面高度的比否否A.10文件验证结果JSON报文结构文件验证结果JSON报文结构见表A.10。表A.10文件验证结果JSON报文结构自定义类型是失败；3:文件未签署是是是签章/消息签名验证结果结构体，见表A.11签章/消息签名验证结果JSON报文结构见表A.11。表A.11签章/消息签名验证结果JSON报自定义类型是签章/签名索引是页面索引列表，如果一个印章同时加盖在多返回-1(因为骑缝章默认加盖所有页面)是是是是是页面图像信息JSON报文结构见表A.12。自定义类型是页面索引，0为起始页是是是数字证书最大长度印章数据最大长度typedefstructSEF_USERS印章ID—对印章状态要求，0:未知；1:有效；2:印章版本typedefstructSEF_SEALDunsignedchar印章当前状态，印章版本印章数据长度typedefstructSEF_USERCtypedefstructSEF_SIGNEDVAunsignedcharunsignedcharunsignedchar电子印章数据长度原文杂凑值二进制数据原文杂凑数据长度DER编码的签章人证书，如果签名使用SM2算原文属性信息长度DER编码的时间戳，应符合GB/T20520时间微数据长度typedefstructSEF_Sunsignedcharb)数据项描述见表B.6表B.6印章信息数据结构参数说明印章标识，对应GB/T38540的csID印章版本印章类型三应符合GB/T338540的规定DE码的签章者证第列表信息器证书列表信息印章图像二进制数据印章图像数据长度印章图像类型，支持“PNG”“BMP”“JPG”印章图像的高度，单位毫米印章图像的宽度，单位毫米B.7定位签章印章信息数据结构a)类型定义typedefstructSEF_POSITIONSEALSIGNINFO{}POSITIONSEALSIGNINFO,印章标识文件页码，页码计数从0开始印章加盖总页数(从pageIndex开始签章),-1表示所有页 印模左上角对应的x坐标与页面宽度的比率印模左上角对应的y坐标与页面高度的比率typedefstructSEF_KEYWORDSEALSIGNINFO{charkeyWord[BUF_SIZE];intpos[BUF_SIintposNum}KEYWORDSEALSIGNINF印章ID 0:所有的关键字；X:从前向后找第X个关键字；关键字位置数目typedefstructSEF_PAGECROSSSEALSIGNINFO{char}PAGECROSSSEALSIGNINFO,*数据项印章标识个骑缝意印权图片所能覆盖的领数上技示覆盖所有页typedefstrueLSEF_ANNOTDATAINFO{b)数据项描述见表B.100:水印注释，注释信息透明度50%;1:普通注释，不透明注释数据类型，0:文字；1:图片dataType=0是表示文字注释数据，UTF-8编码；dataType=1时，表示二进制的图片数据typedefstructSEF_FILEVERIVERIFYSIGNINFO*signInfo错误消息，与resultCode对应的文字描签章/签名索引页面索引列表，如果一个印章同时加盖在多页上，应返回所有页面，如[0,1,2…],骑缝章返回-1(因为骑缝章默认加盖所有页面)签章或者签名格式类型，0:未知；1:GB/T38540;2:GB/T35275;3;GM/T0031;unsigncdchar*页面索引，0为起始页页面图像二进制数据页面图像数据长度"providerName":"goldenr2fwJ0m9E8NYzWKVZvdVtaUgWvsds}{"resultMcssagc":"成功","sealName":"测试印章1","sealName":"测试印章2""status":1.]{r2fwJOm9E8NYzWKVZvdVtaUgWvsdsh"pageIndex":0,//从第0页开始，连续盖3页{"pageIndex":10,//从第10页开始，连续盖2页}响应数据JSON样例："resultMessage":"成功","outFileData":"signSuccess/13454546charpchProviderName[BUF_SIZE]={0};intiProviderNameLen=BUF_SIZE;charpchProviderCompany[BUF_SIZE]={0};intiProviderCompanyLen=BUF_SIZE;charpchProviderVersion[BUF_SIZE]={0};intiVersionLecharpchProviderExtend[BUF_intiExtendLen=BUF_SIZE;intrv=SEF_GetProviderInfo(pchProviderName,&iProviderNameLen,pchProviderC&iProviderCompanyLen,pchProviderVersion,&iProviderVersionLen,pchP