接口描述
查询机构所有印章
接口
/v1/organizations/{orgId}/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，该参数需放在请求地址里面，可以参考【请求示例】 | |
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/organizations/【账户id】/seals?offset=1&size=10Postman请求示例
响应示例
{
"code": 0,
"message": "成功",
"data": {
"total": 3,
"seals": [
{
"sealId": "5d5fb580-cbc0-47dd-ab59-9941a7987955",
"fileKey": "$a91680c3-fb15-4cfd-a459-1a6719c6bb11$616505974",
"width": 159,
"height": 159,
"alias": null,
"sealType": 1,
"defaultFlag": true,
"url": "https://esignoss.esign.cn/seal-service/85b41516-ec49-4ae2-956b-a75a3a9b97ad/d6f59f15-17d4-4886-a769-0a69b05aff5c-openseal.png?Expires=1569318798&OSSAccessKeyId=LTAIdvHfiVrzDKbE&Signature=8ssALBCWyM2i8iYsvGavXEKZrn4%3D",
"status": 1,
"reason": null,
"createDate": 1566790893000,
"sealBizType": "COMMON",
"sealUserFlag": false
},
{
"sealId": "5f9813c5-c521-4c3c-aa62-40b0344a6d53",
"fileKey": "$d17358ec-6e51-4983-a577-4ab0a5287096$2801526178",
"width": 100,
"height": 100,
"alias": "印章别名",
"sealType": 1,
"defaultFlag": false,
"url": "https://esignoss.esign.cn/seal-service/4098bca8-a573-4f56-b57a-3310af86c0e2/c5459acf-ca7d-4af1-94e2-c79bd2a94b72-openseal.png?Expires=1569318798&OSSAccessKeyId=LTAIdvHfiVrzDKbE&Signature=CPs9vFKcZes6gEJv69V2iDrTdJQ%3D",
"status": 1,
"reason": null,
"createDate": 1569311092000,
"sealBizType": "COMMON",
"sealUserFlag": false
},
{
"sealId": "1c17fa52-812a-4149-a96b-1715351f8920",
"fileKey": "$d17358ec-6e51-4983-a577-4ab0a5287096$2801526178",
"width": 50,
"height": 100,
"alias": "芜浣的机构印章别名",
"sealType": 1,
"defaultFlag": false,
"url": "https://esignoss.esign.cn/seal-service/4098bca8-a573-4f56-b57a-3310af86c0e2/c5459acf-ca7d-4af1-94e2-c79bd2a94b72-openseal.png?Expires=1569318798&OSSAccessKeyId=LTAIdvHfiVrzDKbE&Signature=CPs9vFKcZes6gEJv69V2iDrTdJQ%3D",
"status": 1,
"reason": null,
"createDate": 1566956523000,
"sealBizType": "COMMON",
"sealUserFlag": false
}
]
}
}错误码
错误码 | 错误描述 | 解决方案 |
我要纠错