TLS/HTTPS安全概览

对公开域名进行非攻击性的 TLS/HTTPS 基线检查：读取证书有效期、域名匹配、证书链摘要、本次正常握手协商的 TLS 协议/密码套件，并检查 HTTPS 可访问、HTTPS重定向链是否保持HTTPS、HTTP 是否跳转 HTTPS、原始HTTPS入口HSTS与常见安全响应头。不会强制旧协议握手、穷举密码套件或进行漏洞利用。

接口地址

请求方式POST / JSON

身份认证Bearer API Key

所属分类网站与域名

调用费用免费

包月要求不强制包月

调用限制15 次/分钟

补充说明

POST JSON /api/v1/endpoints/tls-check，Bearer API Key。参数 domain 必填，仅公开域名，不含协议、端口、路径或IP；仅执行正常客户端握手和HTTP/HTTPS请求，不进行旧协议强制探测、密码套件穷举或漏洞利用。详细字段和限制参见前台接口文档及 docs/API.md。

请求参数

除 Bearer API Key 请求头外，使用 application/json 发送以下字段。图片接口的文件需先转成纯 Base64 字符串提交。

字段名称	格式	说明
`domain`	字符串	仅域名，不包含协议、端口、路径或IP；只检测公网443/80默认端口

非预期参数将被忽略；非法参数 HTTP 422。接口执行异常统一返回失败响应，不计为成功扣点。请仅提交您有权处理的文本、图片或网页内容。

示例代码

将密钥和业务字段替换为自己的实际值，不要在公开网页或 App 内写入管理员密钥。

cURL

curl -X POST "https://api.dcykjgw.com/api/v1/endpoints/tls-check" \
  -H "Authorization: Bearer dcy_你的完整密钥" \
  -H "Content-Type: application/json" \
  -d '{"domain":"api.dcykjgw.com"}'

JavaScript

fetch('https://api.dcykjgw.com/api/v1/endpoints/tls-check', {
  method: 'POST',
  headers: {'Content-Type':'application/json','Authorization':'Bearer dcy_你的完整密钥'},
  body: JSON.stringify({"domain":"api.dcykjgw.com"})
}).then(r => r.json()).then(console.log);

响应结构

{
  "code": 0,
  "msg": "处理成功",
  "platform": "tls-check",
  "data": {
    "domain": "api.dcykjgw.com",
    "summary": {"status":"good","tls_valid":true,"https_reachable":true,"https_stays_https":true,"hostname_matches":true,"modern_tls":true,"http_redirects_to_https":true,"hsts_present":true},
    "tls": {"negotiated_protocol":"TLSv1.3","cipher_name":"TLS_AES_256_GCM_SHA384","days_remaining":75,"issuer":"示例签发机构","certificate_chain_count":3},
    "https": {"available":true,"http_status":200,"elapsed_ms":120,"final_scheme":"https","stays_https":true},
    "http_to_https": {"checked":true,"redirects_to_https":true},
    "hsts": {"present":true,"max_age":31536000,"include_subdomains":true,"preload":false},
    "recommendations": []
  }
}

summary.status 为 good / attention / unavailable。https_stays_https 会检查HTTPS入口经过重定向后是否仍保持HTTPS；如果最终降级到HTTP，将按安全基线异常提示。HSTS只读取原始被测HTTPS入口的响应，不把跳转后其他域名的HSTS误算到当前域名。negotiated_protocol 只表示一次正常客户端握手实际协商到的协议，不代表服务器只支持这一版本；本接口不会主动强制 TLS 1.0/1.1、穷举密码套件或执行漏洞扫描。证书域名匹配、有效期、HTTP→HTTPS、HSTS及常见安全头仅用于配置基线提示，不构成渗透测试、等保/合规认证或安全保证。

返回参数说明

字段	格式	说明
`code`	数字	业务状态码，0 表示本次接口调用成功；非 0 时结合 msg 和 HTTP 状态码排查。
`msg`	字符串	本次请求结果说明，成功时描述处理结果，失败时给出可读错误原因。
`platform`	字符串	当前接口/平台标识，成功响应中用于区分具体接口来源。
`data`	对象	接口业务数据；具体字段含义见下方本接口字段说明。
`data.domain`	字符串	被检测域名。
`data.summary`	对象	TLS/HTTPS 综合状态与关键布尔判断。
`data.tls`	对象	证书、有效期、域名匹配、协商协议和密码套件信息。
`data.https`	对象	HTTPS 入口可访问性、最终协议及安全头摘要。
`data.http_to_https`	对象	HTTP 是否正确跳转 HTTPS。
`data.hsts`	对象	HSTS 配置及 max-age/includeSubDomains/preload 信息。
`data.recommendations`	字符串数组	发现的配置改进建议。
`data.notice`	字符串	检测范围和使用边界说明。

无效参数 HTTP 422；无效密钥 401；权限限制 403；点数不足 402；频率超限 429；服务暂不可用 503。

在线测试 · TLS/HTTPS安全概览

请填写自己的 API Key。图片只上传到当前 API 请求，不保存到浏览器本地存储；图片 Base64 在下方结果中自动隐藏。

响应结果

填写参数后点击“发送测试请求”。