codecamp

OpenAI 为组织停用证书

为组织停用证书

post /organization/certificates/deactivate

在组织级别停用证书。

每次最多可停用10个证书;此操作具有原子性和幂等性。

请求体参数

内容类型:application/json

  • certificate_ids: array of string

minItems: 1, maxItems: 10

返回值

  • data: array of object { id, active, certificate_details, 3 more }

  • id: string

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

  • active: boolean

证书当前是否在组织级别处于激活状态。

  • certificate_details: object { expires_at, valid_at }

  • 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: "organization.certificate"

对象类型,固定为 organization.certificate。

  • "organization.certificate"

  • object: "organization.certificate.deactivation"

组织证书停用结果的类型。

  • "organization.certificate.deactivation"

示例

## 使用环境变量中的管理员密钥;证书ID和PEM占位内容需换成实际值
curl https://api.openai.com/v1/organization/certificates/deactivate \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
    -d '{
          "certificate_ids": [
            "cert_abc"
          ]
        }'

200 — 示例

译注:官方通用字段示例中 active 为 true;本页后面的具体停用响应为 false。此处保留两组原例,不将通用示意值解释为停用后的实际状态。

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

{
  "data": [
    {
      "id": "id",
      "active": true,
      "certificate_details": {
        "expires_at": 0,
        "valid_at": 0
      },
      "created_at": 0,
      "name": "示例证书名称",
      "object": "organization.certificate"
    }
  ],
  "object": "organization.certificate.deactivation"
}

示例

## 使用环境变量中的管理员密钥;证书ID和PEM占位内容需换成实际值
curl https://api.openai.com/v1/organization/certificates/deactivate \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-H "Content-Type: application/json" \
-d '{
  "certificate_ids": ["cert_abc", "cert_def"]
}'

响应示例

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

{
  "object": "organization.certificate.deactivation",
  "data": [
    {
      "object": "organization.certificate",
      "id": "cert_abc",
      "name": "我的示例证书",
      "active": false,
      "created_at": 1234567,
      "certificate_details": {
        "valid_at": 12345667,
        "expires_at": 12345678
      }
    },
    {
      "object": "organization.certificate",
      "id": "cert_def",
      "name": "我的示例证书2",
      "active": false,
      "created_at": 1234567,
      "certificate_details": {
        "valid_at": 12345667,
        "expires_at": 12345678
      }
    }
  ]
}
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; }