SSL 证书 API 参考 | DomScan 产品

Q: 在哪里可以找到 SSL 证书 的请求和响应参考？

使用 SSL 证书 的 API 参考来查看参数、响应字段、示例、状态码和支持的操作模式。

你将获得什么

获取 SSL 证书信息，包括颁发者、有效期和安全等级。

同步批量RESTMCPSDK交互式工具

适合选择此产品的场景

适用对象

使用范围明确的被动检查来补充分诊和调查，而不是替代授权测试或人工审查。

适合选择此产品的场景

需要在可用范围内检查公开 TLS 证书证据、有效性、名称和链相关信号时选择。

你将获得什么

获取 SSL 证书信息，包括颁发者、有效期和安全等级。

端点

集成前，请查看支持的操作、输入、输出、执行模式和响应限制。

GET /v1/certificates 查看 API 参考

POST /v1/certificates/bulk 查看 API 参考

GET /v1/ssl/audit 查看 API 参考

GET /v1/ssl/deep-scan 查看 API 参考

GET /v1/ssl/grade 查看 API 参考

GET /v1/ssl/chain 查看 API 参考

GET /v1/ssl/expiring 查看 API 参考

积分和身份验证

1-10 需要身份验证。有关确切费用和按项计费，请查看操作参考。

操作示例

使用文档化的操作来收集、评估、补充、验证、比较、保护或监测公开证据。

GET /v1/certificates

查询参数

参数	类型	必需
domain	string	必需
include_subdomains	boolean 默认值 `true`	可选
include_expired	boolean 默认值 `false`	可选
limit	integer 默认值 `100`	可选
cursor	string	可选

响应字段

字段	类型
`domain`	string
`certificates[]`	object[]
`certificates[]`	object
`certificates[].id`	string
`certificates[].issuer`	object
`certificates[].common_name`	string
`certificates[].san[]`	string[]
`certificates[].not_before`	string
`certificates[].not_after`	string
`certificates[].is_expired`	boolean
`certificates[].is_wildcard`	boolean
`certificates[].fingerprint_sha256`	string
`summary`	object
`summary.total_found`	integer
`summary.returned`	integer
`summary.unique_subdomains`	integer
`summary.issuers[]`	string[]
`summary.earliest_cert`	string \| null
`summary.latest_cert`	string \| null
`pagination`	object
`pagination.limit`	integer
`pagination.offset`	integer
`pagination.returned`	integer
`pagination.total`	integer
`pagination.has_more`	boolean
`pagination.next_cursor`	string \| null
`intelligence_summary`	object
`intelligence_summary.data_source`	string
`intelligence_summary.ct_log_sources[]`	string[]
`intelligence_summary.source_count`	integer
`intelligence_summary.cache_status`	string
`intelligence_summary.returned_count`	integer
`intelligence_summary.total_found`	integer
`intelligence_summary.truncated`	boolean
`intelligence_summary.limit`	integer
`intelligence_summary.include_subdomains`	boolean
`intelligence_summary.include_expired`	boolean
`intelligence_summary.unique_name_count`	integer
`intelligence_summary.unique_subdomains`	integer
`intelligence_summary.issuer_count`	integer
`intelligence_summary.wildcard_cert_count`	integer
`intelligence_summary.active_cert_count`	integer
`intelligence_summary.expired_cert_count`	integer
`intelligence_summary.expiring_within_30_days_count`	integer
`intelligence_summary.earliest_cert`	string \| null
`intelligence_summary.latest_cert`	string \| null
`intelligence_summary.latest_expiry`	string \| null
`intelligence_summary.has_more`	boolean
`intelligence_summary.next_cursor`	string \| null
`intelligence_summary.warning_code`	string \| null
`meta`	object

请求示例

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=100"

响应示例

{
  "domain": "example.com",
  "certificates": [
    {
      "id": "example-id",
      "issuer": {},
      "common_name": "example",
      "san": [
        "example"
      ],
      "not_before": "2026-08-27T12:00:00Z",
      "not_after": "2026-08-27T12:00:00Z",
      "is_expired": false,
      "is_wildcard": false,
      "fingerprint_sha256": "example"
    }
  ],
  "summary": {
    "total_found": 1,
    "returned": 1,
    "unique_subdomains": 1,
    "issuers": [
      "example"
    ],
    "earliest_cert": "example",
    "latest_cert": "example"
  },
  "pagination": {
    "limit": 1,
    "offset": 1,
    "returned": 1,
    "total": 1,
    "has_more": false,
    "next_cursor": "example"
  },
  "intelligence_summary": {
    "data_source": "public_data",
    "ct_log_sources": [
      "example"
    ],
    "source_count": 1,
    "cache_status": "live",
    "returned_count": 1,
    "total_found": 1,
    "truncated": false,
    "limit": 1,
    "include_subdomains": false,
    "include_expired": false,
    "unique_name_count": 1,
    "unique_subdomains": 1,
    "issuer_count": 1,
    "wildcard_cert_count": 1,
    "active_cert_count": 1,
    "expired_cert_count": 1,
    "expiring_within_30_days_count": 1,
    "earliest_cert": "example",
    "latest_cert": "example",
    "latest_expiry": "example",
    "has_more": false,
    "next_cursor": "example",
    "warning_code": "example"
  },
  "meta": {}
}