接口地址: http(s)://tool.4759.cn/api/ssl.php
请求方式: GET
返回格式: JSON
字符编码: UTF-8
跨域支持: 全域名允许(Access-Control-Allow-Origin: *)
频率限制: 按API Key等级分级限制(日调用次数/小时调用次数)
授权要求: 必须携带有效的API Key(key参数)
查询方式: 传入纯域名(无需http/https),自动解析443端口SSL证书信息

本API支持解析任意域名的SSL证书完整信息,返回颁发机构、有效期、加密算法、证书链、PEM原文等核心数据,响应快、数据完整、无缓存、纯实时接口。
核心机制: 接口内置API Key授权校验、调用频次限流、域名白名单验证、数据库日志记录等安全机制,确保接口稳定合规。
注意:必须携带有效API Key,未授权无法调用;域名无需加http/https前缀;调用前需确认API Key剩余调用次数。

调用说明

1. 请求参数

参数名 必选 类型 说明 示例值
key string API授权码(需向4759.cn申请,不同等级Key对应不同调用限额) user_21e1f23c7b95faf0609c27be7663dd76
url string 待查询域名(无需http/https,仅保留域名主体) 4759.cn、baidu.com、www.taobao.com

2. 返回参数

参数名 类型 说明
code int 状态码:200成功,-1/-2/401/403/429/500错误
msg string 返回信息(成功/错误描述)
data object SSL证书核心数据(第三方接口返回的完整证书信息)
data.domain string 查询的域名
data.issuer string 证书颁发机构(如Let's Encrypt、DigiCert等)
data.valid_from string 证书生效时间(格式:YYYY-MM-DD HH:MM:SS)
data.valid_to string 证书过期时间(格式:YYYY-MM-DD HH:MM:SS)
data.algorithm string 证书加密算法(如RSA-SHA256、ECDSA-SHA256等)
data.pem string PEM格式证书原文(Base64编码)
call_stats object 当日调用统计(仅200状态返回)
call_stats.used_day int 当日已调用次数
call_stats.remaining_day int 当日剩余调用次数
call_stats.tips string 额外提示(小时调用次数暂不统计)
used_api string 接口标识(4759.cn SSL接口)

3. 状态码说明

调用示例

1. GET请求(最简调用)

https://tool.4759.cn/api/ssl.php?key=user_21e1f23c7b95faf0609c27be7663dd76&url=4759.cn

2. PHP 调用示例(推荐)

<?php // +---------------------------------------------------------------------- // | SSL证书查询API - PHP调用示例代码 // | 复制即可使用,需替换为自己的API Key // +---------------------------------------------------------------------- // 配置参数(必填) $api_key = "user_21e1f23c7b95faf0609c27be7663dd76"; // 替换为你的API Key $query_url = "4759.cn"; // 替换为要查询的域名 // 接口地址(固定) $api_url = "https://tool.4759.cn/api/ssl.php"; // 构造请求参数 $params = [ 'key' => $api_key, 'url' => $query_url ]; $request_url = $api_url . '?' . http_build_query($params); // 初始化CURL并发送请求 $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => $request_url, CURLOPT_RETURNTRANSFER => true, // 返回结果而不是直接输出 CURLOPT_TIMEOUT => 10, // 超时时间10秒 CURLOPT_SSL_VERIFYPEER => false, // 忽略SSL证书验证 CURLOPT_SSL_VERIFYHOST => false, ]); $response = curl_exec($ch); $curl_error = curl_error($ch); curl_close($ch); // 处理请求错误 if ($curl_error) { die("CURL请求错误:" . $curl_error); } // 解析JSON结果 $result = json_decode($response, true); // 输出结果(根据业务逻辑处理) if ($result['code'] == 200) { echo "查询成功!\n"; echo "证书颁发机构:" . $result['data']['issuer'] . "\n"; echo "证书有效期:" . $result['data']['valid_from'] . " 至 " . $result['data']['valid_to'] . "\n"; echo "今日剩余调用次数:" . $result['call_stats']['remaining_day'] . "\n"; } else { echo "查询失败:" . $result['msg'] . "(错误码:" . $result['code'] . ")\n"; } ?>

3. Python 调用示例

import requests import json # 配置参数(必填) api_key = "user_21e1f23c7b95faf0609c27be7663dd76" # 替换为你的API Key query_url = "4759.cn" # 替换为要查询的域名 # 接口地址(固定) api_url = "https://tool.4759.cn/api/ssl.php" # 构造请求参数 params = { "key": api_key, "url": query_url } try: # 发送GET请求,超时时间10秒 response = requests.get(api_url, params=params, timeout=10, verify=False) # 解析JSON结果 result = response.json() # 处理返回结果 if result["code"] == 200: print("查询成功!") print(f"证书颁发机构:{result['data']['issuer']}") print(f"证书有效期:{result['data']['valid_from']} 至 {result['data']['valid_to']}") print(f"今日剩余调用次数:{result['call_stats']['remaining_day']}") else: print(f"查询失败:{result['msg']}(错误码:{result['code']})") except Exception as e: print(f"请求异常:{str(e)}")

4. 成功返回示例

{ "code": 200, "msg": "查询成功", "data": { "domain": "4759.cn", "issuer": "Let's Encrypt Authority X3", "valid_from": "2026-01-01 08:00:00", "valid_to": "2026-04-01 07:59:59", "algorithm": "RSA-SHA256", "pem": "-----BEGIN CERTIFICATE-----\nMIIGDTCCBPWgAwIBAgISA7V0s7hXk11wUf5z+Qn1UuMA0GCSqGSIb3DQEBCwUAMF8xCzAJBgNV\nBAYTAlVTMRYwFAYDVQQKEw1MZXQncyBFbmNyeXB0MQswCQYDVQQDEwJSMzAeFw0yNjAxMDEwOD\nAwMDBaFw0yNjA0MDEwNzk5NTlaMBkxFzAVBgNVBAMTDjQ3NTkuY24gLSBHMzCCASIwDQYJKoZI\nhvcNAQEBBQADggEPADCCAQoCggEBANZ8+..." }, "call_stats": { "used_day": 5, "remaining_day": 995, "tips": "小时调用次数暂不统计" }, "used_api": "4759.cn SSL接口" }

5. 错误返回示例

// 无效API Key { "code": 401, "msg": "无效的API Key,如需帮助请访问:4759.cn" } // 调用频率超限 { "code": 429, "msg": "今日调用次数已达上限,如需帮助请访问:4759.cn" } // 域名未传入 { "code": -1, "msg": "请输入要查询的域名" }

在线测试

输入授权码和域名,点击按钮查询SSL证书信息...
提示:测试Key仅用于体验,调用次数有限,正式使用请申请专属API Key
服务器检测中...