跳到主要内容

证书列表

获取当前用户的证书服务列表。

接口地址​

GET /api/v1/certificate/list

请求参数​

参数名类型必填默认值说明
pageinteger否1页码
page_sizeinteger否15每页数量
statusstring否-证书状态筛选。
可选值：
issuing: 签发中
issued: 已签发
expiring: 即将过期（30天内）
expired: 已过期
keywordstring否-搜索关键词（支持订单号、域名等）。域名支持 punycode 与 Unicode 原文两种写法，例如 xn--fiqs8s 与 中国 都能搜到
fieldsarray否-指定返回字段，例如 ['service_id', 'status', 'domain_dcv']
国际化域名（IDN）

搜索可以传 punycode 也可以传 Unicode 原文；但返回的 domain_dcv 等域名一律是 punycode，请按 punycode 做匹配。

响应示例​

{
    "code": 0,
    "message": "success",
    "data": {
        "current_page": 1,
        "data": [
            {
                "id": 123,
                "service_id": "202310270001",
                "status": "issued",
                "domain_dcv": {
                    "example.com": "dns"
                },
                "product_name": "Certum DV SSL",
                "period": "1 Year",
                "created_at": "2023-10-27 10:00:00",
                "cert_expires_at": "2024-10-27 10:00:00",
                "service_expires_at": "2024-10-27 10:00:00"
            },
            {
                "id": 123,
                "service_id": "202310270001",
                "status": "expiring",
                "domain_dcv": {
                    "example.com": "http"
                },
                "product_name": "Certum DV SSL",
                "period": "1 Year",
                "created_at": "2023-10-27 10:00:00",
                "cert_expires_at": "2024-10-27 10:00:00",
                "service_expires_at": "2024-10-27 10:00:00"
            }
        ],
        "first_page_url": "https://api.example.com/api/v1/certificate/list?page=1",
        "from": 1,
        "last_page": 1,
        "last_page_url": "https://api.example.com/api/v1/certificate/list?page=1",
        "links": [
            {
                "url": null,
                "label": "« Previous",
                "active": false
            },
            {
                "url": "https://api.example.com/api/v1/certificate/list?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next »",
                "active": false
            }
        ],
        "next_page_url": null,
        "path": "https://api.example.com/api/v1/certificate/list",
        "per_page": 15,
        "prev_page_url": null,
        "to": 1,
        "total": 1
    }
}