查询授权印章列表

更新时间：2022-04-07 18:31:36

接口描述

开发者可以根据该接口查询到已经授权给当前应用appid对应的主体企业的印章信息，点击查看更新日志。

开发者需要注意：

印章授权操作是在官网平台进行，后续接口指定授权印章进行盖章的时候，需先通过接口查询到授权印章编号以及授权印章对应的授权主体信息，确保信息无误。
开发者在使用appid调用查询授权印章接口前，需要先通过创建账号接口为appid对应的主体企业信息（被授权方）创建企业账号orgID，并根据orgID查询已经授权的印章信息。

比如：A公司将印章授权给B公司，开发者需要通过B公司的appid并使用B公司的主体企业信息创建企业账号orgID，然后根据orgID通过查询授权印章列表接口查询已经授权给B公司的印章信息。

接口

/v1/organizations/{orgId}/granted/seals

请求方式

GET

请求头

提供两种安全接入方式，开发者可选择其中一种方式进行对接，对应参数如何获取，参考文档【请点击】。

方式一：请求签名鉴权（优先推荐）

请求头入参示例如下：

参数名称	类型	必选	参数说明
X-Tsign-Open-App-Id	string	是	项目ID
Content-Type	string	是	application/json;charset=UTF-8
X-Tsign-Open-Ca-Timestamp	string	是	API 调用者传递时间戳，值为当前时间的毫秒数，也就是从1970年1月1日起至今的时间转换为毫秒，时间戳有效时间为15分钟，为了防重放攻击
Accept	string	是	建议统一填写 /
X-Tsign-Open-Ca-Signature	string	是	签名字符串
Content-MD5	string	否	当请求 Body 非 Form 表单时，可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时，加上此请求头。
X-Tsign-Open-Auth-Mode	string	是	选择请求方式进行鉴权，固定值，Signature

方式二：OAuth2.0鉴权（不推荐使用）

当安全接入选择OAuth2.0鉴权方式，请点击查阅详情，请求头入参示例如下：

参数名称	类型	必选	参数说明
X-Tsign-Open-App-Id	string	是	项目ID
X-Tsign-Open-Token	string	是	通过获取鉴权Token接口返回
Content-Type	string	是	application/json; charset=UTF-8

请求参数

参数名称	类型	必选	参数类型	参数说明
orgId	string	是	path	机构账号id，通过创建机构账号接口获取
downloadFlag	boolean	否	query	是否返回印章图片下载地址，默认为true true-返回下载链接 false-不返回下载链接
offset	integer	否	query	查询页码注：因可能出现印章过多一页展示不下的情况，所以需要指定查询的具体页码。如不指定只显示第一页印章列表。
size	integer	否	query	单页数量注：size最大支持30，如不传默认值是10

公共响应参数

参数名称	类型	必选	参数说明
code	int	是	业务码，0表示成功
message	string	否	信息
data	object	否	业务信息

响应参数

展开全部参数参数名称		类型	必选	参数说明
total		int	否	查询总数
seals		array	否	印章列表
	alias	string	否	印章别名
	createDate	int	否	印章创建时间
	defaultFlag	boolean	否	默认印章标识
	fileKey	string	否	印章fileKey
	height	int	否	印章高度
	width	int	否	印章宽度
	sealId	string	否	印章id
	url	string	否	印章下载地址, 有效时间1小时
	effectiveTime	long	否	授权生效时间
	expireTime	long	否	授权失效时间
	organiztionName	string	否	授权企业主体名称
	idNumber	string	否	授权企业证件号
	idType	string	否	授权企业证件类型（1）CRED_ORG_USCC 统一社会信用代码（2）CRED_ORG_CODE 工商注册号
	sealBizType	string	否	印章业务类型（1）PUBLIC- 公章（2）CONTRACT- 合同专用章（3）FINANCE- 财务章（4）INVOICE- 发票专用章（5）CANCELLATION- 作废章（6）COMMON- 其它

请求示例

GET https://smlopenapi.esign.cn/v1/organizations/【企业账号id】/granted/seals

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "total": 2,
        "seals": [
            {
                "sealId": "93f98d8b-e47***33bff10c",
                "width": 159,
                "height": 159,
                "alias": "印章名称",
                "url": "https://smltapi.esign.cn/openwebserver/v2/seal?sealId=93f98***-9cb4-6c9433bff10c&content=%E4%BB%85%E4%BE%9B%E9%A2%84%E8%A7%88",
                "sealBizType": "COMMON",
                "effectiveTime": 1609171200000,
                "expireTime": 1640793599000,
                "organiztionName": "xxx",
                "idNumber": "21***6",
                "idType": "CRED_ORG_CODE"
            },
            {
                "sealId": "ba1efc74-1***5-2c24772fbd51",
                "width": 159,
                "height": 159,
                "alias": "印章名称",
                "url": "https://smltapi.esign.cn/openwebserver/v2/seal?sealId=ba***a95-2c24772fbd51&content=%E4%BB%85%E4%BE%9B%E9%A2%84%E8%A7%88",
                "sealBizType": "COMMON",
                "effectiveTime": 1609171200000,
                "expireTime": 1640793599000,
                "organiztionName": "xxx",
                "idNumber": "219***6",
                "idType": "CRED_ORG_CODE"
            }
        ]
    }
}

错误码

错误描述

解决方案