SSL证书验证 API文档

# SSL 证书查询 API 文档 查询指定网站的 SSL 证书信息如：证书签发人（机构）、有效期、签名算法、指纹信息等 --- ## 接口说明 - **功能**：输入域名 → 返回 SSL 证书详情（颁发者、有效期、指纹、SAN 等） - **代理**：PHP 统一入口（零依赖、毫秒级转发） - **数据源**：实时 TLS 握手，无需上传证书文件 --- ## 请求地址 ``` https://api.logoi.cn/api/ssl ``` --- ## 请求方法 ``` GET | POST ``` --- ## 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--------|------|------|------| | domain | string | 是* | 目标域名（可带/不带 https://） | --- ## 响应参数（`action=query`） | 字段名 | 类型 | 说明 | |--------|------|------| | maindomain | string | 被检测域名 | | issuerorg | string | 颁发机构组织 | | issuer | string | 颁发者 CN | | valid | string | 固定值“证书有效” | | expired | string | 中文过期提示（含剩余天数） | | starttime | string | 证书生效日期（YYYY-MM-DD） | | endtime | string | 证书失效日期（YYYY-MM-DD） | | sigalgorithm | string | 签名算法（如 sha256WithRSAEncryption） | | altdomains | string | SAN 域名列表（, 分隔） | | fingerprint | string | MD5 指纹（32 位小写） | | fingerprint(SHA256) | string | SHA256 指纹（64 位小写） | --- ## 响应示例 ### ① 查询证书 ```json GET /api/ssl?domain=cloud.tencent.com { "code": 200, "message": "success", "data": { "maindomain": "cloud.tencent.com", "issuerorg": "TrustAsia Technologies, Inc.", "issuer": "TrustAsia RSA DV TLS CA G2", "valid": "证书有效", "expired": "未过期（还剩 87 天）", "starttime": "2024-03-15", "endtime": "2025-03-15", "sigalgorithm": "sha256WithRSAEncryption", "altdomains": "*.cloud.tencent.com, cloud.tencent.com", "fingerprint": "a1b2c3d4e5f6...", "fingerprint(SHA256)": "1a2b3c4d5e6f7g8h9i0j..." }, } ``` --- ## 调用示例 ### 1. 前端（一行 JS） ```javascript // 查询证书 fetch('https://api.logoi.cn/api/ssl?domain=cloud.tencent.com') .then(r => r.json()) .then(d => { const info = d.data; console.log('颁发者:', info.issuer); console.log('到期:', info.endtime); console.log('剩余天数:', info.expired.match(/\d+/)[0]); }); // 健康检查 fetch('https://api.logoi.cn/api/ssl?action=health') .then(r => r.json()) .then(d => console.log('状态:', d.data.status)); ``` ### 2. 后端（一行 PHP） ```php $json = file_get_contents('https://api.logoi.cn/api/ssl?domain=cloud.tencent.com'); $data = json_decode($json, true)['data'] ?? []; echo '到期时间：' . $data['endtime']; ``` --- ## 错误码对照 | HTTP | 错误提示 | 含义 | |------|----------|------| | 400 | 缺少 domain 参数 | 未传域名或格式错误 | | 503 | 后端无响应 | 后端未启动或网络超时 | | 500 | 后端格式异常 | 后端返回非 JSON 格式 | ---