跳转到内容

获取订单列表接口 ​

合作商可通过本接口分页获取当前 API Key 对应用户的全部证书订单。每个订单会附带其证书 ID、期数和状态摘要,便于区分多期证书。

本接口只读取本地数据,不会请求上游 CA,也不会返回私钥或证书 PEM 内容。

请求信息 ​

项目说明
请求地址https://shop.everyonetrust.com/partner/GetOrderList/
请求方式POST
Content-Typeapplication/json 或 application/x-www-form-urlencoded

请求参数 ​

参数类型必填默认值说明
apikeystring是-API 密钥。推荐传 app_id:api_secret,也支持通过 X-API-Key 或 Authorization: Bearer {apikey} 传入。
pageinteger否1页码,从 1 开始。
page_sizeinteger否20每页订单数,范围 1 到 100。

请求示例 ​

bash
curl -X POST "https://shop.everyonetrust.com/partner/GetOrderList/" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ak_xxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{
    "page": 1,
    "page_size": 20
  }'

请求域名

请直接请求 shop.everyonetrust.com。旧域名 shop.ywxmz.com 会先重定向到新域名,部分 HTTP 客户端跟随 301/302 时会把 POST 改为 GET 并丢弃请求体,进而收到 405。

响应参数 ​

分页与订单 ​

参数类型说明
codeinteger业务状态码,200 表示成功。
messagestring响应消息。
data.itemsarray当前页订单列表。无订单时为空数组。
data.pagination.pageinteger当前页码。
data.pagination.page_sizeinteger每页订单数。
data.pagination.totalinteger当前用户的订单总数。
data.pagination.total_pagesinteger总页数;无订单时为 0。
data.items[].order_nostring订单号。
data.items[].order_statusinteger订单状态码。
data.items[].order_status_labelstring订单状态名称。
data.items[].product_idinteger产品 ID。
data.items[].product_namestring产品名称。
data.items[].brand_idinteger品牌 ID。
data.items[].brand_namestring品牌名称。
data.items[].main_domainstring主域名。
data.items[].sans_domainsarray附加单域名。
data.items[].wildcard_domainsarray附加通配符域名。
data.items[].total_domainsinteger域名总数。
data.items[].yearsinteger购买年限。
data.items[].installments_countinteger订单理论总期数。
data.items[].total_amountnumber订单总金额。
data.items[].payment_methodstring支付方式,通常为 balance 或 credit。
data.items[].certificate_countinteger当前订单已建立的证书记录数。
data.items[].certificatesarray当前订单的证书摘要,按期数升序排列。
data.items[].created_atstring/null订单创建时间,ISO 8601 格式。
data.items[].updated_atstring/null订单更新时间,ISO 8601 格式。

证书摘要 ​

参数类型说明
cert_idstring证书唯一 ID。
installment_nointeger证书期数,1 为第一期。
parent_cert_idstring/null前一张关联证书 ID。
cert_statusinteger数据库证书状态码。
cert_status_labelstring数据库证书状态名称。
lifecycle_statusstring有效性状态,如 valid、expiring、expired、issuing。
lifecycle_status_labelstring有效性状态中文名称。
main_domainstring证书主域名。
issued_atstring/null签发时间,ISO 8601 格式。
valid_fromstring/null有效期开始时间。
valid_tostring/null有效期结束时间。

响应示例 ​

json
{
  "code": 200,
  "message": "获取订单列表成功",
  "data": {
    "items": [
      {
        "order_no": "CERT202607041730001234",
        "order_status": 2,
        "order_status_label": "已完成",
        "product_id": 18,
        "product_name": "DV SSL",
        "brand_id": 3,
        "brand_name": "ExampleCA",
        "main_domain": "example.com",
        "sans_domains": [],
        "wildcard_domains": [],
        "total_domains": 1,
        "signature_algorithm": "rsa",
        "hash_algorithm": "sha256",
        "key_spec": "rsa-2048",
        "years": 2,
        "unit_price": 98,
        "installments_count": 2,
        "total_amount": 196,
        "payment_method": "balance",
        "auto_issue_enabled": true,
        "paid_at": "2026-07-04T17:30:00+08:00",
        "created_at": "2026-07-04T17:30:00+08:00",
        "updated_at": "2026-07-14T15:30:00+08:00",
        "certificate_count": 2,
        "certificates": [
          {
            "cert_id": "4a1d9f70-1d53-4f70-8f4f-1d9f701d5333",
            "installment_no": 1,
            "parent_cert_id": null,
            "cert_status": 1,
            "cert_status_label": "签发成功",
            "lifecycle_status": "valid",
            "lifecycle_status_label": "有效",
            "main_domain": "example.com",
            "issued_at": "2026-07-04T18:00:00+08:00",
            "valid_from": "2026-07-04T18:00:00+08:00",
            "valid_to": "2027-07-04T18:00:00+08:00",
            "created_at": "2026-07-04T17:30:00+08:00"
          },
          {
            "cert_id": "5b2e0a81-2e64-4e81-9f5a-2e0a812e6444",
            "installment_no": 2,
            "parent_cert_id": "4a1d9f70-1d53-4f70-8f4f-1d9f701d5333",
            "cert_status": 0,
            "cert_status_label": "等待签发",
            "lifecycle_status": "pending",
            "lifecycle_status_label": "等待签发",
            "main_domain": "example.com",
            "issued_at": null,
            "valid_from": null,
            "valid_to": null,
            "created_at": "2027-06-20T10:00:00+08:00"
          }
        ]
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total": 1,
      "total_pages": 1
    }
  }
}

期数与状态说明 ​

  • installments_count 是订单理论总期数,installment_no 是单张证书所在期数。
  • 重签等操作可能使同一期出现多张证书记录,应使用 cert_id 作为证书的最终唯一标识。
  • cert_status 表示系统处理状态;lifecycle_status 会在签发成功后继续区分有效、即将过期和已过期。
  • expiring 表示证书将在 30 天内到期。

错误码 ​

code说明
401API 密钥无效。
403API 密钥关闭、吊销、过期,IP 不在白名单内,或账号被封禁。
405请求方式错误。
500服务器错误。

EveryoneTrust SSL 文档中心,帮助你稳定完成 HTTPS 运维。