SSL 证书检测

接口标识: sslcheck 价格: 0.005 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

SSL 证书检测接口连接目标域名的 HTTPS 端口，一次解析证书颁发者、主题、SAN 域名列表（最多返回 10 个）、有效期起止、剩余天数、是否过期、序列号、签名算法与协商的 TLS 协议版本。端口默认 443 可自定义，连接超时不超过 10 秒、默认 5 秒。连接失败或证书无法解析时不抛错，返回错误原因并置 expired=true。适合证书到期监控、HTTPS 配置核查与安全巡检场景。

详细介绍

![SSL 证书检测接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_sslcheck__1794363286_7287cdbf453e.png)

证书过期是 HTTPS 站点最常见的事故源。定期核查剩余天数与证书信息，别等用户打不开页面才发现。

## 接口概述
面向依赖 HTTPS 的站点与服务，证书到期、颁发链变化与协议降级都是常见风险点。接口连接域名的 HTTPS 端口，同步返回证书颁发者、主题、SAN 域名列表、起止时间、剩余天数、序列号、签名算法，以及本次实际协商的 TLS 版本；端口与超时可自定义。检测失败不抛异常，而是返回结构化的错误原因，便于接入到期提醒机器人、安全巡检系统与批量域名证书台账，实现证书健康度的自动化监控。

## 核心能力
1. **证书信息全**：颁发者、主题、SAN 列表（最多 10 个）、序列号、签名算法一次返回。
2. **有效期量化**：返回起止时间、剩余天数与是否过期布尔值，可直接设阈值告警。
3. **协议探测**：同时返回本次协商的 TLS 协议版本，便于发现低版本协议风险。
4. **失败不抛错**：连接失败或证书解析失败时返回错误原因并置 expired=true，监控逻辑统一处理。

## 产品优势
1. **接入简单**：传域名即可，端口与超时按需自定义，同步返回。
2. **字段完整**：从颁发信息到协议版本一次拿全，无需多个工具拼凑。
3. **便于监控**：days_left 与 expired 字段可直接写进告警规则。
4. **稳定可靠**：连不上时返回结构化错误，而非请求挂起或异常中断。
5. **降本增效**：一个接口支撑起证书巡检系统，无需自建探测任务。

## 效果展示
一句话理解：它就像给网站查验身份证——谁签发的、叫什么名字、什么时候到期，一次看得清清楚楚。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| domain | www.example.com | 待检测域名，只接受域名不接受 IP |
| port | 443 | SSL 端口，1~65535，默认 443 |
| timeout | 5 | 连接超时秒数，不超过 10 秒，默认 5 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 颁发者 | Example Trust CA R1 | `issuer`，含机构 `O` 与通用名 `CN` |
| 证书主体 | `"www.example.com"` | `subject` |
| 覆盖域名 | www 域名与裸域名两个 | `san`，最多返回 10 个 |
| 有效期 | 2026-03-15 起至 2027-03-15 止 | `not_before` / `not_after`（UTC 时间） |
| 剩余天数 | 125 | `days_left`，配合 `expired` 可做到期告警 |
| 序列号与算法 | 0f0e4a2b9c7d5183 / sha256WithRSAEncryption | `serial_number` / `signature_algorithm` |
| 协商协议版本 | `"TLSv1.3"` | `protocol_version` |

API请求示例：

```
POST /api/sslcheck
domain=www.example.com&port=443&timeout=5
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "domain": "www.example.com",
    "port": 443,
    "issuer": {
      "O": "Example Trust Services",
      "CN": "Example Trust CA R1"
    },
    "subject": {
      "CN": "www.example.com"
    },
    "san": [
      "www.example.com",
      "example.com"
    ],
    "not_before": "2026-03-15 00:00:00",
    "not_after": "2027-03-15 23:59:59",
    "days_left": 125,
    "expired": false,
    "serial_number": "0f0e4a2b9c7d5183",
    "signature_algorithm": "sha256WithRSAEncryption",
    "protocol_version": "TLSv1.3"
  },
  "request_id": "c4e6a8b0d2f1435789ab0cdef1234567"
}
```

days_left 为剩余有效天数，可直接设阈值告警；若连接失败，data 只返回 error 原因并置 expired=true。

## 应用场景
- **到期监控**：每日巡检证书剩余天数，临期自动提醒续签。
- **安全巡检**：核查签名算法与 TLS 版本，及时发现弱配置。
- **上线验收**：验证新站点证书部署是否完整、SAN 是否覆盖访问域名。
- **多域名管理**：为批量域名建立统一的证书健康台账。

## 应用案例
**运维团队负责人**：团队维护数十个站点，证书到期曾靠人工记日历，出过一次漏续导致站点不可访问的事故。现在巡检脚本每天调用本接口，剩余天数低于阈值即告警，顺带核查 TLS 版本与签名算法，证书事故清零。

**安全服务商**：需要为客户定期输出证书健康报告，接入本接口后批量采集颁发者、SAN、有效期与协议版本字段自动生成报告，替代了此前逐个站点手工打开浏览器查看的做法，单次巡检耗时从数小时降到几分钟。

常见问题

Q：连接失败或证书无法解析会怎样？

A：不返回错误码：data 中带 error 说明原因（连接超时、域名解析失败等），并置 expired=true，其余证书字段不返回，监控逻辑可统一按 expired 判断告警。

Q：SAN 域名最多返回几个？

A：最多返回 10 个，证书 SAN 条目更多时会截断。

Q：可以直接检测 IP 地址吗？

A：不可以。domain 只接受域名，传 IP 会返回参数错误；证书校验以域名为口径。

SSL证书 HTTPS 证书监控安全检测

接口地址： https://www.phpwc.cn/api/sslcheck

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`domain`	string	必填	-	待检测域名
`port`	int	选填	`443`	SSL 端口
`timeout`	float	选填	`5`	超时秒数

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`domain`	string	域名
`port`	int	端口
`issuer`−	object	颁发者
`O`	string	机构
`CN`	string	通用名
`subject`−	object	主题
`CN`	string	通用名
`san`	array	SAN 域名数组
`not_before`	string	生效时间
`not_after`	string	过期时间
`days_left`	int	剩余天数
`expired`	boolean	是否过期
`serial_number`	string	序列号
`signature_algorithm`	string	签名算法
`protocol_version`	string	TLS 版本
`error`	string	错误信息
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试