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

Forma parte de la comunidad

La DNS API de regfish es una gran solución para desarrolladores que quieren automatizar dominios y zonas DNS. Súmese a la comunidad y aproveche las ventajas de la automatización DNS. La DNS API está disponible gratis para todos los clientes de regfish.

Mas funciones gratis