获取订单详情

GET

/openapi/v3/orders/:id

获取订单的详细信息。其中证书、组织、联系人和域名验证值的字段说明参见公共响应对象。证书签发后通常会返回证书 PEM、指纹和有效期等字段。

订单状态的完整枚举和含义，参见 订单状态。

Path 参数

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

Query 参数

参数	类型	必填	说明
cert_id	string	否	证书 ID

返回数据

参数名称	类型	描述
id	string	订单 ID
certificate	object	证书详情
∟ id	string	证书 ID
∟ key_len	int	加密长度
∟ key_algo	string	加密算法
∟ license_data	string	授权数据（国密返回）
∟ license_name	string	授权文件名（国密证书返回）
∟ common_name	string	通用名称
∟ dns_names	array	备用名称
∟ sign_hash	string	签名摘要
∟ csr	string	CSR
∟ thumbprint	string	通用 SHA1 指纹（证书签发后有）
∟ pem	string	证书 PEM（证书签发后有）
∟ not_before	string	证书开始时间（证书签发后有）
∟ not_after	string	证书结束时间（证书签发后有）
validity_months	int	订单有效期（单位：月）
validity_days	int	订单自定义有效期（单位：天）；仅支持自定义有效期的产品返回
custom_expiration_date	string	订单自定义到期日；仅支持自定义有效期的产品返回，格式为 YYYY-MM-DD
dcv_method	string	域名验证方式
dcv_val	array[object]	域名验证值（当需要验证域名时返回）
∟ id	string	验证域名 ID
∟ domain	string	验证域名
∟ auth_path	string	验证记录名或文件路径，随验证方式而定
∟ auth_val	string	验证值
∟ verified	boolean	是否已通过本系统预检测；不代表 CA 最终验证结果，CAA、多视角等因素可能导致差异
alternative_order_id	string	备用 ID / 防重复提交 / 限制 64 位
status	string	订单状态，参见 订单状态
status_desc	string	状态描述
valid_from	string	订单开始时间（证书签发后有）
valid_till	string	订单截止时间（证书签发后有）
product_id	string	产品 ID
product_name	string	产品名称
pay_product_id	string	支付产品 ID
remark	string	订单备注（当订单被取消或被拒绝时，备注会包含对应原因）
created_at	string	订单创建时间
updated_at	string	订单更新时间
technical_contact	object	技术联系人，字段结构参见公共响应对象
person_info	object	个人信息，字段结构参见公共响应对象
custom_fields	array[object]	自定义字段列表，字段结构参见公共响应对象
old_order_id	string	续费订单关联的被续费订单 ID；仅续费订单返回
organization	object	组织结构体
∟ id	string	组织 ID
∟ name	string	组织名称
∟ address_line1	string	组织地址
∟ address_line2	string	组织地址 2
∟ city	string	城市
∟ state	string	省份
∟ zip_code	string	邮编
∟ country	string	国家地区代码（如中国 CN）
∟ telephone	string	组织联系电话
∟ admin_user	object	联系人信息
∟ ∟ first_name	string	联系人名称
∟ ∟ last_name	string	联系人姓氏
∟ ∟ job_title	string	联系人职位
∟ ∟ telephone	string	联系人电话
∟ ∟ email	string	联系人邮箱
∟ contact	object	联系人信息
∟ ∟ first_name	string	联系人名称
∟ ∟ last_name	string	联系人姓氏
∟ ∟ job_title	string	联系人职位
∟ ∟ telephone	string	联系人电话
∟ ∟ email	string	联系人邮箱
∟ end_user_id	string	终端用户标识
∟ created_time	string	组织创建时间
∟ status	string	状态

curl -X GET 'https://api.certcloud.cn/openapi/v3/orders/9q6PEiRQ' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id'

fetch('https://api.certcloud.cn/openapi/v3/orders/9q6PEiRQ', {
  headers: {
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id'
  }
});

req, _ := http.NewRequest("GET", "https://api.certcloud.cn/openapi/v3/orders/9q6PEiRQ", nil)
req.Header.Set("X-CC-Auth-Key", "your-auth-key")
req.Header.Set("X-CC-Key-ID", "your-key-id")
client := &http.Client{}
resp, _ := client.Do(req)

import requests

requests.get(
    'https://api.certcloud.cn/openapi/v3/orders/9q6PEiRQ',
    headers={
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id'
    }
)

200成功

{
  "data": {
    "id": "jdWa1lod",
    "certificate": {
      "id": "hoCMzIMz",
      "common_name": "csq.isw.app",
      "dns_names": ["csq.isw.app"],
      "sign_hash": "SHA256",
      "thumbprint": "49D8AD6A676112AC5DF1CBC06DA80936BB0B2276",
      "pem": "-----BEGIN CERTIFICATE-----\nMIIF5jCCBE6gAwIBAgIRAPqZxr4q81YM4AlRCb1YK8kw...\n-----END CERTIFICATE-----\n",
      "not_before": "2022-06-27 00:00:00",
      "not_after": "2022-09-25 23:59:59"
    },
    "validity_months": 12,
    "dcv_method": "cname",
    "dcv_val": [
      {
        "domain": "csq.isw.app",
        "auth_path": "_B8C4158B18DFF0A63118A8C453EDC56A.csq",
        "auth_val": "88392273862A3E5DD9472ECD109F01CF.39EC2E75A88D682DF32274B550CDCC75.CertClouddtf9djhcudm.trust-provider.com",
        "verified": true,
        "dcv_method": "cname"
      }
    ],
    "product_id": "trustasia_c1_ssl_free",
    "status": "issued",
    "valid_from": "2022-06-27",
    "valid_till": "2023-06-27",
    "created_at": "2022-06-27 09:08:32"
  },
  "code": "success"
}