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 de ondersteunde bewerkingen, invoer, uitvoer, uitvoeringsmodi en responslimieten.

GET /v1/certificates API-referentie bekijken
POST /v1/certificates/bulk API-referentie bekijken
GET /v1/ssl/audit API-referentie bekijken
GET /v1/ssl/deep-scan API-referentie bekijken
GET /v1/ssl/grade API-referentie bekijken
GET /v1/ssl/chain API-referentie bekijken
GET /v1/ssl/expiring API-referentie bekijken

Credits en authenticatie

1-10 Authenticatie vereist. Bekijk de bewerkingsreferentie voor de exacte kosten en eventuele prijs 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

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
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=100"

Voorbeeldantwoord

{
  "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": {}
}

Beperkingen en grenzen van het bewijs

Resultaten beschrijven waargenomen openbaar bewijs en de herkomst ervan.
De dekking wordt begrensd door de gedocumenteerde inputs, budgetten, bronnen en responslimieten.
Bulkbewerkingen verwerken meerdere ondersteunde inputs en behouden de gedocumenteerde resultaten per item.
Onbekend betekent dat het gevraagde feit niet kon worden vastgesteld op basis van het beschikbare bewijs.
Bewijs kan in de loop van de tijd veranderen. Gebruik tijdstempels en velden voor actualiteit wanneer die beschikbaar zijn.

Beoordeeld op 2026-08-22

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?

Onbekende of gedeeltelijke resultaten betekenen dat het gevraagde bewijs niet volledig kon worden vastgesteld. Houd de resultaatstatus, betrouwbaarheid, actualiteit en beperkingen bij in vervolgbeslissingen.

Hoe wordt SSL-certificaten geprijsd?

De prijs hangt af van de bewerking en uitvoeringsmodus. Bekijk de endpointreferentie voor de actuele creditkosten, authenticatievereiste en regels per item.

Gebruikt door mensen bij geweldige bedrijven

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeMotionElementsLLM Pulse