Säkerhet och tillit · DomScan-produkt

SSL-certifikat API-referens

Få SSL-certifikatinformation inklusive utgivare, giltighet och säkerhetsklass.

Det här får du

Få SSL-certifikatinformation inklusive utgivare, giltighet och säkerhetsklass.

SynkrontBulkRESTMCPSDKInteraktivt verktyg

Välj denna produkt när

Vem är det till för?

Använd avgränsade passiva kontroller för att berika triage och utredning, inte för att ersätta auktoriserad testning eller mänsklig granskning.

Välj denna produkt när

Välj detta för att inspektera offentliga TLS-certifikatbevis, giltighet, namn och kedjerelaterade signaler där de finns.

Det här får du

Få SSL-certifikatinformation inklusive utgivare, giltighet och säkerhetsklass.

Endpoints

Se vad varje endpoint accepterar och returnerar, dess lägen och begränsningar innan du integrerar.

GET /v1/certificates Visa API-referens
POST /v1/certificates/bulk Visa API-referens
GET /v1/ssl/audit Visa API-referensLäs guiden
GET /v1/ssl/deep-scan Visa API-referensLäs guiden
GET /v1/ssl/grade Visa API-referensLäs guiden
GET /v1/ssl/chain Visa API-referensLäs guiden
GET /v1/ssl/expiring Visa API-referensLäs guiden

Credits och autentisering

1-10 Autentisering krävs. Se API-referensen för den exakta kostnaden, inklusive eventuell prissättning per post.

Exempel på operation

Använd dokumenterade operationer för att samla in, bedöma, berika, verifiera, jämföra, skydda eller övervaka offentliga bevis.

GET /v1/certificates Krediter: 2

Frågeparametrar

Parameter Typ obligatorisk
domain string obligatorisk
include_subdomains boolean
Standard true
valfri
include_expired boolean
Standard false
valfri
limit integer
Standard 100
valfri
cursor string valfri

Svarsfält

Fält Typ
has_more boolean
next_cursor string | null
cache_age_s integer
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

Exempelbegäran

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=example"
const response = await fetch("https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=example", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=example",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=example", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=example")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

Exempelsvar

{
  "domain": "example.com",
  "certificates": [
    {
      "id": "16234550871",
      "issuer": {
        "name": "R11",
        "organization": "Let's Encrypt"
      },
      "common_name": "www.example.com",
      "san": [
        "example.com",
        "www.example.com"
      ],
      "not_before": "2026-09-14T08:12:44",
      "not_after": "2026-12-13T08:12:43",
      "is_expired": false,
      "is_wildcard": false
    },
    {
      "id": "16198877412",
      "issuer": {
        "name": "R11",
        "organization": "Let's Encrypt"
      },
      "common_name": "api.example.com",
      "san": [
        "api.example.com"
      ],
      "not_before": "2026-08-20T14:03:10",
      "not_after": "2026-11-18T14:03:09",
      "is_expired": false,
      "is_wildcard": false
    }
  ],
  "summary": {
    "total_found": 14,
    "returned": 2,
    "unique_subdomains": 3,
    "issuers": [
      "Let's Encrypt"
    ],
    "earliest_cert": "2026-08-20T14:03:10",
    "latest_cert": "2026-09-14T08:12:44"
  },
  "pagination": {
    "limit": 2,
    "offset": 0,
    "returned": 2,
    "total": 14,
    "has_more": true,
    "next_cursor": "2"
  },
  "intelligence_summary": {
    "data_source": "crt.sh",
    "ct_log_sources": [
      "crt.sh"
    ],
    "source_count": 1,
    "cache_status": "live",
    "returned_count": 2,
    "total_found": 14,
    "truncated": true,
    "limit": 2,
    "include_subdomains": true,
    "include_expired": false,
    "unique_name_count": 3,
    "unique_subdomains": 3,
    "issuer_count": 1,
    "wildcard_cert_count": 0,
    "active_cert_count": 2,
    "expired_cert_count": 0,
    "expiring_within_30_days_count": 0,
    "earliest_cert": "2026-08-20T14:03:10",
    "latest_cert": "2026-09-14T08:12:44",
    "latest_expiry": "2026-12-13T08:12:43",
    "has_more": true,
    "next_cursor": "2",
    "warning_code": null
  },
  "meta": {
    "source": "crt.sh",
    "ct_log_sources": [
      "crt.sh"
    ],
    "query_time_ms": 1240,
    "cached": false,
    "page": {
      "limit": 2,
      "offset": 0,
      "returned": 2,
      "total": 14,
      "has_more": true,
      "next_cursor": "2"
    },
    "served_by": "pop=MAD country=ES"
  }
}

HTTP-statuskoder

  • 200 OK
  • 400 Felaktig begäran
  • 401 Obehörig
  • 402 Betalning krävs
  • 429 För många begäranden
  • 503 Tjänsten är inte tillgänglig
  • 504 Gateway-timeout

Vanliga frågor

Var hittar jag request- och response-referensen för SSL-certifikat?

Använd API-referensen för SSL-certifikat för att granska parametrar, svarsfält, exempel, statuskoder och stödda körningslägen.

Hur ska jag tolka okända eller ofullständiga resultat från SSL-certifikat?

Okänt eller delvis betyder att vi inte kunde bekräfta resultatet fullt ut. Ta hänsyn till status, säkerhet, aktualitet och eventuella begränsningar när du agerar på det.

Hur prissätts SSL-certifikat?

Priset beror på kontrollen och det läge du väljer. API-referensen visar den aktuella kreditkostnaden, om du behöver en API-nyckel och eventuell prissättning per post.

Används av människor på dessa företag

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse