查询个人印章

更新时间：2024-01-29 18:05:31

接口描述

查询个人所有印章

接口

/v1/accounts/{accountId}/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

请求参数

参数名称	类型	必选	参数类型	参数说明	示例值
accountId	string	是	path	用户id，该参数需放在请求地址里面，可以参考【请求示例】
offset	integer	是	query	分页起始位置
size	integer	是	query	单页数量

公共响应参数

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

响应参数

展开全部参数参数名称		类型	必选	参数说明	示例值
seals		array	否	印章列表
	alias	string	否	印章别名
	createDate	int64	否	印章创建时间
	defaultFlag	boolean	否	默认印章标识
	fileKey	string	否	印章fileKey
	height	int	否	印章高度
	width	int	否	印章宽度
	sealId	string	否	印章id
	sealType	int	否	印章类型（1）1-机构模板章（2）2-个人模板章（3）3-自定义印章
	url	string	否	印章下载地址, 有效时间1小时
	sealBizType	string	否	印章业务类型 COMMON-其它
total		int	否	查询总数

请求示例

GET https://smlopenapi.esign.cn/v1/accounts/【账户id】/seals?offset=1&size=10

Postman请求示例

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "total": 5,
        "seals": [
            {
                "sealId": "21171728-7ad2-4c0a-adb7-b0fa02fe28b5",
                "fileKey": "$a324aa79-aa6e-4747-b7f9-58bc54a6e9fa$2270656502",
                "width": 136,
                "height": 136,
                "alias": null,
                "sealType": 2,
                "defaultFlag": true,
                "url": "https://esignoss.esign.cn/seal-service/844ae6fe-9600-43b1-b572-59232355cad1/a2ea1d67-1783-4a40-a829-77dedc4df814-openseal.png?Expires=1569318190&OSSAccessKeyId=LTAIdvHfiVrzDKbE&Signature=xa9qHcYuu7pD9oEaJVYjhuJ2bPY%3D",
                "status": 1,
                "reason": null,
                "createDate": 1569207346000,
                "sealBizType": "COMMON",
                "sealUserFlag": false
            },
            {
                "sealId": "3ab4e747-3aba-4e03-99ac-6374b136daa6",
                "fileKey": "$1f91e216-2543-4b63-bd9f-7a0b01bab250$4128181936",
                "width": 100,
                "height": 100,
                "alias": "印章别名",
                "sealType": 3,
                "defaultFlag": false,
                "url": "https://esignoss.esign.cn/seal-service/44ac7b6e-198a-479a-8a7b-7db070861338/c14353ce-bab9-483a-bff1-ca887dce0e44-openseal.png?Expires=1569318190&OSSAccessKeyId=LTAIdvHfiVrzDKbE&Signature=11L0R0ddBp8dAtERTBv5D1nCoqM%3D",
                "status": 1,
                "reason": null,
                "createDate": 1569313733000,
                "sealBizType": "COMMON",
                "sealUserFlag": false
            },
            {
                "sealId": "e4e1800a-32d3-4deb-89ce-73eae5b79779",
                "fileKey": "$1ff7d5eb-9c58-4f89-8687-5054c9874a62$1548902775",
                "width": 50,
                "height": 100,
                "alias": "芜浣的印章别名",
                "sealType": 1,
                "defaultFlag": false,
                "url": "https://esignoss.esign.cn/seal-service/8f276136-e1c6-4acd-a720-de7ff5865ae2/cc4920e1-51a5-46e1-ab8b-53b2c339b3b8-openseal.png?Expires=1569318190&OSSAccessKeyId=LTAIdvHfiVrzDKbE&Signature=siEAEqXgVacFYljs1HnMbFT3FIs%3D",
                "status": 1,
                "reason": null,
                "createDate": 1569311438000,
                "sealBizType": "COMMON",
                "sealUserFlag": false
            },
            {
                "sealId": "41d9b1ce-d848-403c-9a9c-184f9cbd5e56",
                "fileKey": "$216f8325-2714-42b8-8381-94c53c984b02$3368092071",
                "width": 100,
                "height": 100,
                "alias": "芜浣",
                "sealType": 2,
                "defaultFlag": false,
                "url": "https://esignoss.esign.cn/seal-service/e9cf6332-a728-4724-bab3-117880883f59/783f31c3-d3f3-45e0-8f84-be9f51331906-openseal.png?Expires=1569318190&OSSAccessKeyId=LTAIdvHfiVrzDKbE&Signature=sSF/vou1Mp7PdAZ8WJ%2BY7mGuMtY%3D",
                "status": 1,
                "reason": null,
                "createDate": 1569308088000,
                "sealBizType": "COMMON",
                "sealUserFlag": false
            },
            {
                "sealId": "15ebf9e7-f1f3-423f-b155-f1806236464e",
                "fileKey": "$216f8325-2714-42b8-8381-94c53c984b02$3368092071",
                "width": 100,
                "height": 100,
                "alias": "芜浣的印章别名",
                "sealType": 2,
                "defaultFlag": false,
                "url": "https://esignoss.esign.cn/seal-service/e9cf6332-a728-4724-bab3-117880883f59/783f31c3-d3f3-45e0-8f84-be9f51331906-openseal.png?Expires=1569318190&OSSAccessKeyId=LTAIdvHfiVrzDKbE&Signature=sSF/vou1Mp7PdAZ8WJ%2BY7mGuMtY%3D",
                "status": 1,
                "reason": null,
                "createDate": 1569307849000,
                "sealBizType": "COMMON",
                "sealUserFlag": false
            }
        ]
    }
}

错误码

错误描述

解决方案

电子签名 SaaS API 非标版

查询个人印章

接口描述

接口

请求方式

请求头

方式一：请求签名鉴权

方式二：OAuth2.0鉴权

请求参数

公共响应参数

响应参数

请求示例

Postman请求示例

响应示例

错误码