Verify DNSSEC state | regfish DNS & TLS API

POST

/dns/{domain}/dnssec/verify

DomainDNSSECVerifyByDomain

Authentifizierung

x-api-key

SchnellstartAuthentifizierung Regfish ConsoleAPI-Key im Regfish-Interface anlegen und testen

Parameter

Name

Typ

Format

Pflicht

Description

domain

path

string

—

Pflicht

Fully Qualified Domain Name.

Request-Beispiel

POST

curl --request POST \
  --url 'https://api.regfish.com/dns/www.example.com/dnssec/verify' \
  --header 'x-api-key: YOUR_API_KEY'

Responses

200

DNSSEC verification result

application/jsondnssecResponse

Response-Beispiel 200

{
  "success": true,
  "code": 0,
  "response": {
    "configured": true,
    "dnssec_state": "active",
    "mode": "none",
    "desired_state": "disabled",
    "live_state": "disabled",
    "capabilities": {
      "supported": true,
      "provider": "example",
      "mode_regfish_available": true,
      "mode_external_available": true,
      "accepted_record_kinds": [
        "ds"
      ],
      "min_records": 1,
      "accepted_algorithms": [
        1
      ]
    },
    "desired_records": [
      {
        "kind": "ds",
        "algorithm": 1
      }
    ],
    "live_records": [
      {
        "kind": "ds",
        "algorithm": 1
      }
    ],
    "using_regfish_nameservers": true,
    "legacy_mode": true,
    "zone_signed": true,
    "zone_pending_disable": true
  }
}

401

Unauthorized

application/jsonError

Response-Beispiel 401

{
  "success": false,
  "message": "Unauthorized",
  "error": "Unauthorized"
}

404

Domain not found

application/jsonError

Response-Beispiel 404

{
  "success": false,
  "message": "Domain not found",
  "error": "Domain not found"
}

502

DNSSEC verification failed

application/jsonError

Response-Beispiel 502

{
  "success": false,
  "message": "DNSSEC verification failed",
  "error": "DNSSEC verification failed"
}

Verwandte Modelle

baseResult

dnssecCapabilities

dnssecDisplayState

High-level DNSSEC status.

dnssecJobResponse

dnssecMode

Requested DNSSEC operating mode. - `none`: no registry DNSSEC should remain active - `regfish`: regfish signs the zone and manages registry trust anchors - `external`: the caller supplies DNSSEC records for external authoritative nameservers

Fine-grained registry DNSSEC state.

Error

fqdn_relaxed

Fully Qualified Domain Name.

Werde ein Teil der Community

Das DNS API von Regfish ist die perfekte Lösung für Entwickler, die ihre Domains und DNS-Zonen automatisieren möchten. Werde Teil der Community und profitiere von den Vorteilen der DNS-Automatisierung. Das DNS API steht jedem Regfish-Kunden kostenlos zur Verfügung.