云签章申请

1 获取鉴权 Token

1.1 接口描述

通过GRANT_TYPE和CLIENT_ID以及CLIENT_SECRET获取授权码Token,用来请求api接口。当授权码Token即将到期时需要调用接口重新获取授权码Token。服务端允许开发者多次调用“获取鉴权 Token”接口获取授权码Token。但只有最新获取的授权码Token的有效时长为30分钟。

1.2 接口地址

http://cloud.ezca.org:10000/open/oauth/token

1.3 请求方式

POST

1.4 请求参数

参数名称	类型	必填	参数类型	参数说明	示例值	备注说明
client_Id	string	是	query	应用 appKey	Title	Title
client_secret	string	是	query	应用密钥，不可泄露 appSecret	Title	Title
grant_type	string	是	query		client_credent ials	此处为默认： client_credent ials

1.5 响应参数

参数名称	类型	必填	参数说明	示例值	备注说明
access_token	string	否	授权码
token_type	string	否	类型	bearer	bearer
expires_in	string	否	Token 有效剩余	8999	时间会慢慢减少，直到重新请求获取新的为止
scope	string	否		api1userProfile

2 创建电子印章

2.1 接口描述

通过传入相关参数，创建电子印章

2.2 接口地址

http://127.0.0.1:30000/sdk/signature/v2/seal/create

2.3 请求方式

POST

2.4 请求参数

参数名称	类型	必填	参数类型	参数说明	示例值	备注说明
Authorization	string	是	headers	令牌	例如 : Bearer 9d2ace49- 64e9-4bdd-9c07- dd8325d1f8e0	此处，为了获取请求权限，必须先获取令牌，否则会提示令牌失效
sealType	string	是	body	印章类型	1	1：个人印章 2：企业印章
sealName	string	是	body	印章名称；个人为姓名，企业为企业名称	个人：张三企业：东方中讯	个人：姓名企业：企业名称
companyName	string	否 body	企业名称	东方中讯	制作个人印章时存在企业就写企业名称，不存在就不填写；制作企业印章时必填
idNumber	string	是	body	个人为身份证号码，企业为统一社会信用代码	123456789	如果 sealType 类型为1，则填个人身份证号码; 如果 sealType 类型为2，则填写企业统一社会信用代码
serialNumber	string	是	body	业务流水号	123456789	此为生成印章的业务流水号，可以传入查询某个签章的业务流水
sealNumber	string	否	body	印章号码	123456	申请个人印章可以不填写，企业印章为必填

2.5 响应参数

参数名称	类型	参数说明	示例值	备注说明
id	string	印章 ID	授权码
certId	string	印章证书 ID	类型	bearer
name	string	印章名称		时间会慢慢减少，直到重新请求获取新的为止
data	string	印章结构体 Base64 编码		印章结构体遵循《GB∕T 38540-2020 信息安全技术安全电子签章密码技术规范》
pictures	string	印章图片Base64 编码
serialNumber	string	印章创建的业务流水号		使用印章时，需要该业务流水号获取印章
startTime	Date	印章有效期开始时间
endTime	Date	印章有效期结束时间
sealStatus	Integer	印章状态		0：可用； 1：冻结； 2：失效

3 通过图片创建电子印章

3.1 接口描述

通过传入相关参数，创建电子印章

3.2 接口地址

http://127.0.0.1:30000/sdk/signature/v2/seal/create/picture

3.3 请求方式

POST

3.4 请求参数

参数名称	类型	必填	参数类型	参数说明	示例值	备注说明
Authorization	string	是	headers	令牌	例如 : Bearer 9d2ace49- 64e9-4bdd-9c07- dd8325d1f8e0	此处，为了获取请求权限，必须先获取令牌，否则会提示令牌失效
sealType	string	是	body	印章类型	1	1：个人印章 2：企业印章
sealName	string	是	body	印章名称；个人为姓名，企业为企业名称	个人：张三企业：东方中讯	个人：姓名企业：企业名称
companyName	string	否 body	企业名称	东方中讯	制作个人印章时存在企业就写企业名称，不存在就不填写；制作企业印章时必填
idNumber	string	是	body	个人为身份证号码，企业为统一社会信用代码	123456789	如果 sealType 类型为1，则填个人身份证号码; 如果 sealType 类型为2，则填写企业统一社会信用代码
serialNumber	string	是	body	业务流水号	123456789	此为生成印章的业务流水号，可以传入查询某个签章的业务流水
sealPic	string	否	body	印章图片	123456	图片大小不能超过 100Kb

3.5 响应参数

参数名称	类型	参数说明	示例值	备注说明
id	string	印章 ID	授权码
certId	string	印章证书 ID	类型	bearer
name	string	印章名称		时间会慢慢减少，直到重新请求获取新的为止
data	string	印章结构体 Base64 编码		印章结构体遵循《GB∕T 38540-2020 信息安全技术安全电子签章密码技术规范》
pictures	string	印章图片Base64 编码
serialNumber	string	印章创建的业务流水号		使用印章时，需要该业务流水号获取印章
startTime	Date	印章有效期开始时间
endTime	Date	印章有效期结束时间
sealStatus	Integer	印章状态		0：可用； 1：冻结； 2：失效

4 查询签章信息

4.1 接口描述

通过传入印章 id,查询签章信息

4.2 接口地址

http://127.0.0.1:30000/sdk/signature/v2/seal/info

4.3 请求方式

POST

4.4 请求参数

参数名称	类型	必填	参数类型	参数说明	示例值	备注说明
Authorization	string	是	headers	令牌	例如 : Bearer 9d2ace49- 64e9-4bdd-9c07- dd8325d1f8e0	此处，为了获取请求权限，必须先获取令牌，否则会提示令牌失效
serialNumber	string	是	body	申请印章的业务流水号		必填，用于哪个签章签名

4.5 响应参数

参数名称	类型	参数说明	示例值	备注说明
id	string	印章 ID	授权码
certId	string	印章证书 ID	类型	bearer
name	string	印章名称		时间会慢慢减少，直到重新请求获取新的为止
data	string	印章结构体 Base64 编码		印章结构体遵循《GB∕T 38540-2020 信息安全技术安全电子签章密码技术规范》
pictures	string	印章图片Base64 编码
serialNumber	string	印章创建的业务流水号		使用印章时，需要该业务流水号获取印章
startTime	Date	印章有效期开始时间
endTime	Date	印章有效期结束时间
sealStatus	Integer	印章状态		0：可用； 1：冻结； 2：失效

5 对 PDF 文件盖章签名

5.1 接口描述

通过位置坐标对 pdf 文件签名

5.2 接口地址

http://127.0.0.1:30000/sdk/signature/v2/seal/cert/sign

5.3 请求方式

POST

5.4 请求参数

参数名称	类型	必填	参数类型	参数说明	示例值	备注说明
Authorization	string	是	headers	令牌	例如 : Bearer 9d2ace49- 64e9-4bdd-9c07- dd8325d1f8e0	此处，为了获取请求权限，必须先获取令牌，否则会提示令牌失效
serialNumber	string	是	body	创建盖章时的业务流水号		必填
pdfFile	file	是	body	带签署的 pdf 文件		必填，带签署的 pdf 文件
sealPoint	string	是	body	印章位置不能为空,其中 picW：表示图片横坐标位置，以文档左下角为原点，（非必填） picH：表示图片纵坐标位置，以文档左下角为原点，（非必填） page：签名图片所在页码（必填） imageW：签名图片宽（非必填） imageH：签名图片高（非必填）		必填
isCtS	Integer	否	body	盖章后是否允许其他人继续添加印章;0:允许;1:不允许;	1

5.5 响应参数

参数名称	类型	参数说明	示例值	备注说明
data	string	签名后 pdf 文件的 Base64 编码		签名后 pdf 文件的 Base64 编码

6 通过关键字对 PDF 文件盖章签名

6.1 接口描述

通过关键字对 PDF 文件盖章签名

6.2 接口地址

http://127.0.0.1:30000/sdk/signature/v2/seal/pdf/keyword/sign

6.3 请求方式

POST

6.4 请求参数

参数名称	类型	必填	参数类型	参数说明	示例值	备注说明
Authorization	string	是	headers	令牌	例如 : Bearer 9d2ace49- 64e9-4bdd-9c07- dd8325d1f8e0	此处，为了获取请求权限，必须先获取令牌，否则会提示令牌失效
serialNumber	string	是	body	创建盖章时的业务流水号		必填
pdfFile	file	是	body	带签署的 pdf 文件		必填，带签署的 pdf 文件
keyword	string	是	body	关键字
isCtS	Integer	否	body	盖章后是否允许其他人继续添加印章;0:允许;1:不允许;	1

6.5 响应参数

参数名称	类型	参数说明	示例值	备注说明
data	string	签名后 pdf 文件的 Base64 编码		返回的是签章后的 Pdf 文件的 Base64 数据

7 对 PDF 文件盖骑缝章签名

7.1 接口描述

对 PDF 文件盖骑缝章签名

7.2 接口地址

http://127.0.0.1:30000/sdk/signature/v2/ride/seal/sign

7.3 请求方式

POST

7.4 请求参数

参数名称	类型	必填	参数类型	参数说明	示例值	备注说明
Authorization	string	是	headers	令牌	例如 : Bearer 9d2ace49- 64e9-4bdd-9c07- dd8325d1f8e0	此处，为了获取请求权限，必须先获取令牌，否则会提示令牌失效
serialNumber	string	是	body	创建盖章时的业务流水号		必填
pdfFile	file	是	body	带签署的 pdf 文件		必填，带签署的 pdf 文件
sealPoint	string	是	body	印章位置不能为空,其中 sealType：0:单侧单开,1: 双侧双开,默认为 0 单侧单开sealCut：X 页均分一个章，X 大于 2 小于 32（文档大于 32 页时，会多于页码会继续盖章） startPage：签章开始的页码；sealPage：签章所在的页码,0:全部页码,1:奇数页码,2:偶数页码,默认为 0 所有页码； sealPicY：印章 Y 坐标	[{"sealType":0, "sealCut":2,"st artPage":1, "sealPage":0, "sealPicY":0}]
isCtS	Integer	否	body	盖章后是否允许其他人继续添加印章;0:允许;1:不允许;	1

7.5 响应参数

参数名称	类型	参数说明	示例值	备注说明
data	string	签名后 pdf 文件的 Base64 编码		返回的是签章后的 Pdf 文件的 Base64 数据

8 证书查询

8.1 接口描述

对证书信息进行查询

8.2 接口地址

http://127.0.0.1:30000/sdk/signature/v2/seal/cert/info

8.3 请求方式

POST

8.4 请求参数

参数名称	类型	必填	参数类型	参数说明	示例值	备注说明
Authorization	string	是	headers	令牌	例如 : Bearer 9d2ace49- 64e9-4bdd-9c07- dd8325d1f8e0	此处，为了获取请求权限，必须先获取令牌，否则会提示令牌失效
serialNumber	string	是	body	盖章文件使用的印章对应业务流水号		必填

8.5 响应参数

参数名称	类型	参数说明	示例值	备注说明
data	string	签名后 pdf 文件的 Base64 编码		返回的是签章后的 Pdf 文件的 Base64 数据

为什么要使用电子印章？