必须确保企业用户已授予平台appId获取其印章资源管理的权限，点击查看如何授权
- manage_org_seal - 授权允许获取企业/组织用户的印章的查询、新增、编辑、授权、删除权限
接口描述
查询 orgId （机构企业）名下自身创建的内部自有企业印章，包括印章的编号、名称、状态、印章业务类型、印章图片下载地址等信息。
接口地址&请求方法
接口地址：https://{host}/v3/seals/org-own-seal-list?orgId=xx&pageNum=1&pageSize=20
请求方法：GET
请求头格式
具体请求头参数，请查看公共请求头格式。
请求参数
参数名称 | 参数类型 | 必选 | 参数位置 | 参数说明 |
orgId | string | 是 | query | 机构账号ID 【注】用户在e签宝注册实名后才有账号ID，账号ID获取方式请使用【查询机构认证信息】接口通过组织机构名称/组织机构证件号进行查询 |
pageNum | int32 | 是 | query | 查询页码 |
pageSize | int32 | 是 | query | 每页显示的数量，最大值：20 |
sealBizTypes | string | 否 | query | 印章业务类型（多项可使用英文逗号分隔） PUBLIC - 公章 CONTRACT - 合同专用章 FINANCE - 财务专用章 PERSONNEL - 人事专用章 LEGAL_PERSON - 法定代表人章 COMMON - 其他 |
响应参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数说明 | ||||
code | int32 | 是 | 业务码，0表示成功，非0表示异常。 | ||||
message | string | 否 | 业务信息 请根据 code 来判断错误情况，不应该依赖 message 匹配，因为 message 可能会调整。 | ||||
data（点击“+”展开详情） | object | 否 | 业务数据 | ||||
total | int64 | 否 | 查询印章总数 | ||||
seals（点击“+”展开详情） | array | 否 | 印章列表信息 | ||||
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-own-seal-list?orgId=0c5***fbf&pageNum=1&pageSize=20&sealBizTypes=PUBLIC响应示例
{
"message": "成功",
"code": 0,
"data": {
"total": 1,
"seals": [
{
"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"
}
]
}
}
我要纠错