延长订单服务时长

POST

/openapi/v3/orders/:id/extend

用于在订单订阅期内延长订单服务年限。extend_years 取值必须大于等于 1。

注意

延长订单服务时长会涉及计费，该功能并非普遍开放；如需开通，请联系客户经理。

Path 参数

参数	类型	必填	说明
id	string	是	订单 ID

Body 参数 application/json

参数	类型	必填	说明
extend_years	int	是	延长年限（单位：年），最小值为 1

返回数据

参数名称	类型	描述
order_id	string	订单 ID
old_validity_years	int	延长前总服务年限
new_validity_years	int	延长后总服务年限
new_expiration_date	string	新的订单到期时间（日期字符串）

curl -X POST 'https://api.certcloud.cn/openapi/v3/orders/TIT6R0qv/extend' \
  -H 'Content-Type: application/json' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id' \
  -d '{
    "extend_years": 1
  }'

const response = await fetch('https://api.certcloud.cn/openapi/v3/orders/TIT6R0qv/extend', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id',
  },
  body: JSON.stringify({ extend_years: 1 })
})
const data = await response.json()

body := map[string]interface{}{"extend_years": 1}
jsonBody, _ := json.Marshal(body)
req, _ := http.NewRequest("POST",
  "https://api.certcloud.cn/openapi/v3/orders/TIT6R0qv/extend",
  bytes.NewBuffer(jsonBody))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-CC-Auth-Key", "your-auth-key")
req.Header.Set("X-CC-Key-ID", "your-key-id")
resp, err := http.DefaultClient.Do(req)

import requests

response = requests.post(
    'https://api.certcloud.cn/openapi/v3/orders/TIT6R0qv/extend',
    headers={
        'Content-Type': 'application/json',
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    },
    json={'extend_years': 1}
)
data = response.json()

200成功

{
  "data": {
    "order_id": "TIT6R0qv",
    "old_validity_years": 1,
    "new_validity_years": 2,
    "new_expiration_date": "2027-12-31"
  },
  "code": "success"
}