Get DNSSEC configuration

Retrieve the current DNSSEC configuration and status for the specified domain. Important response fields: - desired_state: the target DNSSEC state - live_state: the last state observed from the registry and delegation checks - dnssec_state: high-level status for quick status checks (active, pending, inactive) - pending_job: the current DNSSEC transition job, if processing is still in progress DNSSEC changes can be asynchronous, so desired_state and live_state may differ temporarily.

GET

/dns/{domain}/dnssec

DomainDNSSECByDomain

Authentication

x-api-key

Getting startedAuthentication Customer areaCreate an API key in the regfish console and test it

Parameters

Name

Type

Format

Required

Description

domain

path

string

Required

Fully Qualified Domain Name.

Request example

GET

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

Responses

200

DNSSEC configuration

application/jsondnssecResponse

Response example 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 example 401

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

404

Domain not found

application/jsonError

Response example 404

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

500

Unexpected error

application/jsonError

Response example 500

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

Community

Devenez membre de la communauté

L'API DNS regfish est une excellente solution pour les développeurs qui souhaitent automatiser les domaines et les zones DNS. Faites partie de la communauté et bénéficiez de l'automatisation DNS. L'API DNS est disponible gratuitement pour chaque client regfish.

Plus de fonctionnalités gratuites