必须确保企业用户已授予平台appId获取其印章资源管理的权限,点击查看如何授权
- manage_org_seal - 授权允许获取企业/组织用户的印章的查询、新增、编辑、授权、删除权限
接口描述
指定具体的机构印章(只支持企业内部印章,不包含授权的印章),查询印章详细信息。
接口地址&请求方法
接口地址:https://{host}/v3/seals/org-seal-info?orgId=xx&sealId=xx
请求方法:GET
请求头格式
具体请求头参数,请查看公共请求头格式。
请求参数
参数名称 | 参数类型 | 必选 | 参数位置 | 参数说明 |
orgId | string | 是 | query | 机构账号ID 【注】用户在e签宝注册实名后才有账号ID,账号ID获取方式请使用【查询机构认证信息】接口通过组织机构名称/组织机构证件号进行查询 |
sealId | string | 是 | query | 印章编号 |
响应参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数说明 | |||
code | int32 | 是 | 业务码,0表示成功,非0表示异常。 | |||
message | string | 否 | 业务信息 请根据 code 来判断错误情况,不应该依赖 message 匹配,因为 message 可能会调整。 | |||
data(点击“+”展开详情) | object | 否 | 业务数据 | |||
sealId | string | 否 | 印章ID(印章编号) | |||
sealName | string | 否 | 印章名称 | |||
sealCreateTime | int64 | 否 | 印章创建时间,Unix时间戳格式,单位毫秒。 | |||
defaultSealFlag | boolean | 否 | 是否为机构默认印章 true - 默认印章,false - 非默认印章 | |||
sealHeight | int32 | 否 | 印章高度(单位:毫米mm) | |||
sealWidth | int32 | 否 | 印章宽度(单位:毫米mm) | |||
sealBizType | string | 否 | 印章业务类型 PUBLIC - 公章 CONTRACT - 合同专用章 FINANCE - 财务专用章 PERSONNEL - 人事专用章 LEGAL_PERSON - 法定代表人章 COMMON - 其他 | |||
sealBizTypeDescription | string | 否 | 印章业务类型说明 | |||
sealStyle | int32 | 否 | 印章制作方式 | |||
sealStatus | int32 | 否 | 印章状态 1 - 已启用,2 - 待审核, 3 - 审核不通过,4 - 挂起 | |||
statusDescription | string | 否 | 印章状态描述 | |||
rejectReason | string | 否 | 审核意见,图片印章审核不通过时,会返回审核不通过的原因 | |||
sealImageDownloadUrl | string | 否 | 印章图片(带水印)下载地址(有效期60分钟) |
请求示例
GET https://openapi.esign.cn/v3/seals/org-seal-info?orgId=c7e007**41e7&sealId=53642310-xx-xx-xx-xxx
响应示例
{
"message": "成功",
"code": 0,
"data": {
"sealId": "53642310-xx-xx-xx-xxx",
"sealName": "xx企业章",
"sealCreateTime": 1651748074000,
"defaultSealFlag": false,
"sealWidth": 40,
"sealHeight": 40,
"sealBizType": "PUBLIC",
"sealBizTypeDescription": "公章",
"sealStyle": 40,
"sealStatus": 1,
"statusDescription": "已启用",
"rejectReason": "",
"sealImageDownloadUrl": "https://esignoss.esign.cn/seal-service/xx-xx-xx-xx/xx-xx-xx-x-openseal.png?Expires=xx&OSSAccessKeyId=xx&Signature=xx"
}
}