缩减订单服务时长

POST

/openapi/v3/orders/:id/shrink

用于缩减订单服务年限，与延长订单服务时长相对。shrink_years 取值必须大于等于 1；适用订单和最终可缩减年限以产品规则为准。

注意

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

Path 参数

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

Body 参数 application/json

参数	类型	必填	说明
shrink_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/shrink' \
  -H 'Content-Type: application/json' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id' \
  -d '{
    "shrink_years": 1
  }'

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

body := map[string]interface{}{"shrink_years": 1}
jsonBody, _ := json.Marshal(body)
req, _ := http.NewRequest("POST",
  "https://api.certcloud.cn/openapi/v3/orders/TIT6R0qv/shrink",
  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/shrink',
    headers={
        'Content-Type': 'application/json',
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    },
    json={'shrink_years': 1}
)
data = response.json()

200成功

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