获取域名的SSL证书信息，包括颁发者、到期时间、剩余天数等。
获取域名的SSL证书信息，包括颁发者、到期时间、剩余天数等。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| domain | string | 是 | 查询域名 |
[
{
"name": "domain",
"type": "string",
"required": true,
"description": "查询域名",
"example": ""
}
]{"openapi":"3.1.1","info":{"title":"域名SSL证书查询","description":"获取域名的SSL证书信息，包括颁发者、到期时间、剩余天数等。","version":"1.0.0"},"paths":{"/apis/gateway?api=sslcheck":{"get":{"summary":"域名SSL证书查询","description":"获取域名的SSL证书信息，包括颁发者、到期时间、剩余天数等。","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"},"description":"查询域名"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"域名SSL证书查询","description":"获取域名的SSL证书信息，包括颁发者、到期时间、剩余天数等。","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"},"description":"查询域名"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"https://api.souxiaocha.com","description":"当前访问入口（https）"}]}
{"success":true,"data":{"domain":"www.wengbi.com","common_name":"*.wengbi.com","issuer":"Asseco Data Systems S.A.","organization":null,"valid_from":"2026-06-15 11:12:56","valid_to":"2026-12-31 11:12:55","is_expired":false,"is_not_yet_valid":false,"days_remaining":142,"status_text":"正常"},"generated_at":"2026-08-11 13:02:53"}https://api.souxiaocha.com/apis/gateway?api=sslcheckGET https://api.souxiaocha.com/apis/gateway?api=sslcheck apikey=你的API密钥&domain=请填写domain
GET 参数放在查询字符串中。参数值请替换为实际有效值。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
domain | string | 是 | 查询域名 |
{"success":true,"data":{"domain":"www.wengbi.com","common_name":"*.wengbi.com","issuer":"Asseco Data Systems S.A.","organization":null,"valid_from":"2026-06-15 11:12:56","valid_to":"2026-12-31 11:12:55","is_expired":false,"is_not_yet_valid":false,"days_remaining":142,"status_text":"正常"},"generated_at":"2026-08-11 13:02:53"}获取域名的SSL证书信息，包括颁发者、到期时间、剩余天数等。
https://api.souxiaocha.com/apis/gateway?api=sslcheckGET / POST（业务参数 GET 通过 URL 传递，POST 支持表单或 JSON）
调用需携带平台密钥（用户中心「令牌管理」获取，SK- 开头）：
key=SK-你的密钥X-API-Key: SK-你的密钥| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| domain | string | 是 | 查询域名 |
[
{"name": "domain", "type": "string", "required": true, "description": "查询域名"}
]成功返回示例：
{"success":true,"data":{"domain":"www.wengbi.com","common_name":"*.wengbi.com","issuer":"Asseco Data Systems S.A.","organization":null,"valid_from":"2026-06-15 11:12:56","valid_to":"2026-12-31 11:12:55","is_expired":false,"is_not_yet_valid":false,"days_remaining":142,"status_text":"正常"},"generated_at":"2026-08-11 13:02:53"}失败返回示例：
{"success":false,"error":"connection_failed","message":"无法连接到该域名"}| 参数名 | 类型 | 说明 |
|---|---|---|
| data.domain | string | 查询域名 |
| data.common_name | string | 证书通用名称（CN） |
| data.issuer | string | 证书颁发机构 |
| data.organization | string | 组织名称（O） |
| data.valid_from | string | 证书生效时间 |
| data.valid_to | string | 证书到期时间 |
| data.is_expired | boolean | 是否已过期 |
| data.is_not_yet_valid | boolean | 是否尚未生效 |
| data.days_remaining | integer | 剩余有效天数 |
| data.status_text | string | 状态描述：正常/即将过期/已过期/尚未生效 |
curl "https://api.souxiaocha.com/apis/gateway?api=sslcheck?key=SK-你的密钥&domain=douhao.com"上游业务级错误：
| code | msg | 描述 |
|---|---|---|
| 400 | missing_domain | 缺少domain参数 |
| 502 | connection_failed | 无法连接到目标域名 |
| 502 | ssl_not_enabled | 目标域名未启用SSL |
| 502 | cert_parse_failed | SSL证书解析失败 |
平台级错误（errcode）：11001 缺少密钥 / 11002 密钥无效或已禁用 / 11005 接口禁用 / 11006 接口维护 / 11010 积分不足 / 11018 请求方式不允许。
失败时请以响应体中的 code / errcode 与 msg 判断。
2026-09-24
curl "https://api.souxiaocha.com/apis/gateway?api=sslcheck?key=SK-你的密钥&domain=douhao.com"// 结果将在此处显示