SSL 证书检测

概述

通过域名远程探测其 HTTPS/SSL 证书信息：颁发者、颁发机构、签名算法、覆盖域名、有效期、是否过期、距过期天数、SHA-1 指纹、远端 IP 等。 • 智能预处理：自动剥离 http(s):// 前缀、路径、查询串、端口、www. 子域 • 严格域名校验：合法域名格式（最长 253 字符 + RFC 1123 标签规则）才打服务 • 三态响应：有 SSL（is_ssl=true）→ 完整信息；无 SSL/连接失败 → is_ssl=false 其余字段 null；服务异常 → 502 • 字段标准化：服务 null 字段透传 null 不补 0；自动转 int/string 类型；is_expire 重命名 is_expired • 缓存策略：成功 6h（证书短期不变）；无证书 30min（避免错误域名反复打服务）

鉴权

匿名每日 30 次、QPS 2；登录用户每日 100 次、QPS 5（全部免费）。命中 6 小时缓存不计入服务配额。

获取 API Key：获取 API Key/account/keys

请求参数

GET · QUERY STRING · https://v1.apizero.cn/api/ssl?domain=apizero.cn

返回结果

顶层固定为 code / msg / data。下表一般是 data 内字段。 code · msg · data · tips · request_id

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "domain": "apizero.cn",
    "common_name": "*.apizero.cn",
    "domains": [
      "*.apizero.cn",
      "apizero.cn"
    ],
    "issuing_agency": "Asseco Data Systems S.A.",
    "issuer": "Certum DV TLS G2 R39 CA",
    "signature_algorithm": "RSA-SHA256",
    "is_ssl": true,
    "is_expired": false,
    "life_span_days": 198,
    "expire_days": 184,
    "start_date": "2026-04-22 17:05:00",
    "expire_date": "2026-11-07 17:04:59",
    "fingerprint": "f4633adfd1cb59185ba094dc3edeef5a8ea26889",
    "remote_address": "119.36.225.184:443"
  },
  "request_id": "abc123def456",
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/ssl?domain=apizero.cn"

错误码

先看业务 code。HTTP 也可能不是 200。

调用限制

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

• 1.0.02026-05-07

  首次上线，/api/domain/checkssl 智能 domain 预处理：自动剥离 http(s):// 前缀 / 路径 / 端口 / www. 子域 严格 RFC 1123 域名格式校验，无效输入直接 4000，节省服务配额 字段重命名：is_expire → is_expired（更地道英文）；sn → signature_algorithm；life_span_in_days → life_span_days 类型规范化：服务 null 字段保留 null（不像源码无脑 ?? "" / ?? 0），前端可正确判空 不返回服务 raw_json 字段（含 10K+ X.509 详细信息，绝大多数前端用不到） 缓存策略：成功 6h / 无证书 30min（避免错误域名反复打付费服务）

免责声明