5. Certs API 配置文件

URL: https://api-client.apeirocdn.com/api/v1/resources/certs

1. 获取证书清单

Method: GET

① 示范 (curl 模式)

curl --location 'https://api-client.apeirocdn.com/api/v1/resources/certs?groupName=cdn-xxx&from=0&size=10&filters=keypairname:mycert' \
--header 'Cookie: access_token=my-token'

Parameter:

栏位	类型	预设/填写范例	描述
groupName	String	groupName=cdn-xxx	项目的群组名称
from	Integer	Default: 0 Example: from=0	从 n 开始检索
size	Integer	Default: 10 Example: size=10	要检索的项目的数量
filters	String	Default: " " filters=itemName:my_name Example: filters=keypairname:example.com_acme	用于检索项目的过滤器。 使用 +AND 来分隔过滤特征 使用 * 作为通配符 itemName=栏位名称 my_name=该栏位后面的 value

2. 添加证书

Method: POST

① 示范 (curl 模式)

curl --location --request POST \
  --url 'https://api-client.apeirocdn.com/api/v1/resources/certs?groupName=cdn-xxx' \
  --header 'content-type: application/json' \
  --header 'Cookie: access_token=my-token' \
  --data '{
    "keypairname": "mycert",
    "certpemRaw": "-----BEGIN CERTIFICATE----- ... -----END CERTIFICATE-----",
    "certkeyRaw": "-----BEGIN PRIVATE KEY----- ... -----END PRIVATE KEY-----"
  }'

Parameter:

栏位	类型	预设/填写范例	描述
groupName	String	groupName=cdn-xxx	项目的群组名称

Body:

栏位	类型	预设/填写范例	描述
keypairname	String	Example:"keypairname:"mycert"	凭证名称，不允许包含 _acme 等字串
certpemRaw	String	Example:"certpemRaw": "-----BEGIN CERTIFICATE-----\nMIIG......\n-----END CERTIFICATE-----\n" (x509 PEM 格式)	凭证的 x509 格式内容
certkeyRaw	String	Example:"certkeyRaw": "-----BEGIN RSA PRIVATE KEY-----\nMIIE......\n-----END RSA PRIVATE KEY-----\n" (PEM 格式)	凭证对应的私钥

3. 获取证书信息

Method: GET

① 示范 (curl 模式)

curl --location --request GET 'https://api-client.apeirocdn.com/api/v1/resources/certs/{keypairId}?groupName=cdn-xxx' \
--header 'Cookie: access_token=my-token'

Path:

栏位	类型	预设/填写范例	描述
keypairId	String	cdn-xxx-mycert	要检索的凭证 ID

Parameter:

栏位	类型	预设/填写范例	描述
groupName	String	groupName=cdn-xxx	项目的群组名称

4. 更新证书信息

Method: PATCH

① 示范 (curl 模式)

curl --location --request PATCH 'https://api-client.apeirocdn.com/api/v1/resources/certs/{keypairId}?groupName=cdn-xxx' \
--header 'Content-Type: application/json' \
--header 'Cookie: access_token=my-token' \
--data '{
    "certpemRaw": "-----BEGIN CERTIFICATE----- ... -----END CERTIFICATE-----",
    "certkeyRaw": "-----BEGIN PRIVATE KEY----- ... -----END PRIVATE KEY-----"
}'

Path:

栏位	类型	预设/填写范例	描述
keypairId	String	cdn-xxx-mycert	要更新的凭证 ID

Parameter:

栏位	类型	预设/填写范例	描述
groupName	String	groupName=cdn-xxx	项目的群组名称

Body:

栏位	类型	预设/填写范例	描述
certpemRaw	String	Example:"certpemRaw": "-----BEGIN CERTIFICATE-----\nMIIG......\n-----END CERTIFICATE-----\n" (x509 PEM 格式)	新的 x509 格式凭证内容
certkeyRaw	String	Example:"certkeyRaw": "-----BEGIN RSA PRIVATE KEY-----\nMIIE......\n-----END RSA PRIVATE KEY-----\n" (PEM 格式)	新的凭证私钥

5. 删除证书信息

Method: DELETE

① 示范 (curl 模式)

curl --location --request DELETE 'https://api-client.apeirocdn.com/api/v1/resources/certs/{keypairId}?groupName=cdn-xxx' \
--header 'Cookie: access_token=my-token'

Path:

栏位	类型	预设/填写范例	描述
keypairId	String	cdn-xxx-mycert	要删除的凭证 ID

Parameter:

栏位	类型	预设/填写范例	描述
groupName	String	groupName=cdn-xxx	项目的群组名称