跳转到主要内容
1签 (OneSign)

SigningCertificates

本页内容

当前应用可用的证书列表。查看权限与选择证书权限分别检查,不能用列表读取代替实际授权。

如何阅读本模型

先从下方相关接口确认该模型用于请求还是响应,再按字段层级读取。请求模型由调用方填写,响应模型由平台返回;同名字段在不同模型中可能含义不同。

应用、版本、任务和回执的区别见基本概念。需要一份可跟做的示例时,从相关接口进入对应产品指南。

字段定义

“必需”指字段所在的对象出现时,该字段是否必须存在。类型中含 null 表示值允许为空;未返回、null、空字符串和零分别处理。

字段必需说明
app_id 是

业务应用的完整 ID,来自列出应用或预留新应用的响应。

类型:string

查看取值约束
  • 格式 ^A[a-f0-9]{32}$
items 是

与当前请求条件匹配的记录。数组元素的字段见下方各行。

类型:object[]

查看取值约束
  • 最多元素 1000
items[].id 是

该条记录的公开标识。调用后续接口时请完整保留,包括前缀。

类型:string

查看取值约束
  • 格式 ^C[a-f0-9]{32}$
items[].label 是

用于选择和区分证书的公开备注。

类型:string

查看取值约束
  • 最多字符 255
items[].team 是

证书对应的团队信息。

类型:string

查看取值约束
  • 最多字符 255
items[].certificate_expires 是

证书本身的到期时间文本,不是签名套餐的到期时间。

类型:string

查看取值约束
  • 最多字符 80
items[].profile_expires 是

描述文件本身的到期时间文本。

类型:string

查看取值约束
  • 最多字符 80
items[].selected 是

此证书是否为当前应用已选用的证书。

类型:boolean

相关接口

下面根据接口定义列出使用本模型的操作,包括嵌套在其他对象中的情况。接口示例展示完整请求和响应;模型本身不会增加任何权限。

作为成功响应