codecamp

OpenAI 获取证书

获取证书

get /organization/certificates/{certificate_id}

获取已上传到组织的证书。

无论证书是否处于激活状态,都可获取。

路径参数

  • certificate_id: string

要获取的证书的唯一 ID。

查询参数

  • include: optional array of "content"

要在响应中额外包含的字段列表。目前仅支持 content,用于获取证书的 PEM 内容。

  • "content"

返回值

  • Certificate object { id, certificate_details, created_at, 3 more }

表示已上传到组织的单个 certificate(证书)。

  • id: string

标识符,可在 API 端点中引用。

  • certificate_details: object { content, expires_at, valid_at }

  • content: optional string

PEM 格式的证书内容。

  • expires_at: optional integer

证书过期时间的 Unix 时间戳,单位为秒。

format: unixtime

  • valid_at: optional integer

证书开始有效的时间,以 Unix 时间戳表示,单位为秒。

format: unixtime

  • created_at: integer

证书上传时间的 Unix 时间戳,单位为秒。

format: unixtime

  • name: string or null

证书名称。

  • object: "certificate" or "organization.certificate" or "organization.project.certificate"

对象类型。

  • 创建、更新或获取指定证书时,对象类型为 certificate。
  • 列出组织证书,或为组织激活、停用证书时,对象类型为 organization.certificate。
  • 列出项目证书,或为项目激活、停用证书时,对象类型为 organization.project.certificate。

  • "certificate"

  • "organization.certificate"

  • "organization.project.certificate"

  • active: optional boolean

证书当前是否在指定范围内处于激活状态。获取指定证书的详细信息时不返回此字段。

示例

## 使用环境变量中的管理员密钥;证书ID和PEM占位内容需换成实际值
curl https://api.openai.com/v1/organization/certificates/$CERTIFICATE_ID \
    -H "Authorization: Bearer $OPENAI_ADMIN_KEY"

200 — 示例

译注:官方通用字段示例列出了 active;字段说明指出,获取指定证书详情时不返回该字段。下方保留原示例,不据此推断上传会自动激活。

以下为字段结构示例;字段名、证书ID和协议固定值按原文保留。

{
  "id": "id",
  "certificate_details": {
    "content": "content",
    "expires_at": 0,
    "valid_at": 0
  },
  "created_at": 0,
  "name": "示例证书名称",
  "object": "certificate",
  "active": true
}

示例

## 使用环境变量中的管理员密钥;证书ID和PEM占位内容需换成实际值
curl --globoff "https://api.openai.com/v1/organization/certificates/cert_abc?include[]=content" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY"

响应示例

以下为对应请求的响应示例。时间值和证书内容仅作结构展示。

{
  "object": "certificate",
  "id": "cert_abc",
  "name": "我的示例证书",
  "created_at": 1234567,
  "certificate_details": {
    "valid_at": 1234567,
    "expires_at": 12345678,
    "content": "-----BEGIN CERTIFICATE-----MIIDeT...-----END CERTIFICATE-----"
  }
}
OpenAI 上传证书
OpenAI 修改证书
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

其他能力与进阶指南

Embeddings 接口参考

审计日志接口参考

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }