OpenAI 列出项目证书

2026-11-17 18:23 更新

列出项目证书

get /organization/projects/{project_id}/certificates

列出此项目的证书。

路径参数

  • project_id: string

项目 ID。

查询参数

  • after: optional string

分页游标。after 是标记列表位置的对象 ID。例如,列表请求返回100个对象,最后一个为 obj_foo;后续调用可传入 after=obj_foo,以获取下一页。

  • limit: optional integer (default: 20)

返回的对象数量上限。取值范围为1至100,默认值为20。

  • order: optional "asc" or "desc" (default: "desc")

按对象的 created_at 时间戳排序。asc 为升序,desc 为降序。

  • "asc"

  • "desc"

返回值

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

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

  • "organization.project.certificate"

  • first_id: string or null

  • has_more: boolean

  • last_id: string or null

  • object: "list"

  • "list"

示例

## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects/$PROJECT_ID/certificates" \
    -H "Authorization: Bearer $OPENAI_ADMIN_KEY"

200 — 示例

{
  "data": [
    {
      "id": "id",
      "active": true,
      "certificate_details": {
        "expires_at": 0,
        "valid_at": 0
      },
      "created_at": 0,
      "name": "示例名称",
      "object": "organization.project.certificate"
    }
  ],
  "first_id": "cert_abc",
  "has_more": true,
  "last_id": "cert_abc",
  "object": "list"
}

示例

## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects/proj_abc/certificates" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY"

响应示例

{
  "object": "list",
  "data": [
    {
      "object": "organization.project.certificate",
      "id": "cert_abc",
      "name": "示例证书",
      "active": true,
      "created_at": 1234567,
      "certificate_details": {
        "valid_at": 12345667,
        "expires_at": 12345678
      }
    }
  ],
  "first_id": "cert_abc",
  "last_id": "cert_abc",
  "has_more": false
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号