Beveiliging & vertrouwen · DomScan-product

SSL-certificaten API-referentie

Krijg SSL-certificaatinformatie, inclusief certificeringsinstantie, geldigheid en veiligheidskwaliteit.

Wat je krijgt

Krijg SSL-certificaatinformatie, inclusief certificeringsinstantie, geldigheid en veiligheidskwaliteit.

SynchroonBulkRESTMCPSDKInteractieve tool

Kies dit product wanneer

Voor wie is dit?

Gebruik begrensde passieve controles om triage en onderzoek te verrijken, niet om geautoriseerde tests of menselijke beoordeling te vervangen.

Kies dit product wanneer

Kies dit om openbaar TLS-certificaatbewijs, geldigheid, namen en ketengerelateerde signalen te inspecteren waar beschikbaar.

Wat je krijgt

Krijg SSL-certificaatinformatie, inclusief certificeringsinstantie, geldigheid en veiligheidskwaliteit.

Endpoints

Bekijk vóór de integratie wat elk endpoint accepteert en teruggeeft, plus de modi en limieten.

GET /v1/certificates API-referentie bekijken
POST /v1/certificates/bulk API-referentie bekijken
GET /v1/ssl/deep-scan API-referentie bekijkenLees de gids

Credits en authenticatie

1-10 Authenticatie vereist. Zie de API-referentie voor de exacte kosten, inclusief eventuele prijzen per item.

Voorbeeldbewerking

Gebruik gedocumenteerde bewerkingen om openbaar bewijs te verzamelen, te beoordelen, te verrijken, te verifiëren, te vergelijken, te beschermen of te monitoren.

GET /v1/certificates Tegoeden: 2

Queryparameters

Parameter Type vereist
domain string vereist
include_subdomains boolean
Standaard true
optioneel
include_expired boolean
Standaard false
optioneel
limit integer
Standaard 100
optioneel
cursor string optioneel

Antwoordvelden

Veld Type
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

Voorbeeldverzoek

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))

Voorbeeldantwoord

{
  "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-statuscodes

  • 200 OK
  • 400 Ongeldig verzoek
  • 401 Niet geautoriseerd
  • 402 Betaling vereist
  • 429 Te veel verzoeken
  • 503 Service niet beschikbaar
  • 504 Gateway-time-out

Veelgestelde vragen

Waar vind ik de request- en response-referentie voor SSL-certificaten?

Gebruik de API-referentie voor SSL-certificaten om parameters, responsevelden, voorbeelden, statuscodes en ondersteunde uitvoeringsmodi te bekijken.

Hoe moet ik onbekende of onvolledige resultaten van SSL-certificaten interpreteren?

Onbekend of gedeeltelijk betekent dat we het resultaat niet volledig konden bevestigen. Houd rekening met de status, betrouwbaarheid, actualiteit en eventuele limieten wanneer u erop handelt.

Hoe wordt SSL-certificaten geprijsd?

De prijs hangt af van de controle en de modus die u kiest. De API-referentie toont de actuele kosten in credits, of u een API-sleutel nodig hebt en eventuele prijzen per item.

Gebruikt door mensen bij deze bedrijven

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse