文档中心

Appearance

查询订单交付偏好 ​

GET
/openapi/v3/orders/:id/delivery-chain-preferences

查询订单已保存的各链族交付偏好。需要订单访问权限。此接口只返回已保存记录；确认某张证书实际获取到的路径，请读取证书详情中的 Certificate.cross_chain。

请求参数 ​

路径参数类型必填说明
idstring是订单 ID

无查询参数、请求体和分页参数。

返回数据 ​

字段类型说明
order_idstring订单 ID
preferencesarray[object]已保存的链族偏好；无记录时为 []
∟ family_codestring交付链族
∟ cross_chaininteger已保存的路径编号；0 表示未指定登记路径，实际交付还受交叉链开关及默认配置影响

同一订单可以保存多个链族的偏好；获取某张证书时，服务端根据实际 ICA 匹配对应链族。preferences=[] 与包含 cross_chain=0 的记录含义不同，详见证书链选择与交付。

本接口不返回交叉链开关状态；重颁发或续期传 -1 / 1 后，已保存的路径编号仍可保持不变，应通过证书详情确认实际交付结果。

请求示例 ​

替换示例订单 ID 和鉴权值后调用。

bash
curl 'https://api.certcloud.cn/openapi/v3/orders/TIT6R0qv/delivery-chain-preferences' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id'

响应示例 ​

以下编号、名称和指纹仅为示例；实际选择请使用本账户接口返回的值。

200成功
json
{
  "code": "success",
  "data": {
    "order_id": "TIT6R0qv",
    "preferences": [
      {
        "family_code": "example-rsa",
        "cross_chain": 1002
      }
    ]
  }
}

无记录时成功返回 {"code":"success","data":{"order_id":"TIT6R0qv","preferences":[]}}，不会自动生成继承记录。错误处理见证书链错误码。