NAST (1.0.1)

Download OpenAPI specification:Download

E-mail: team-dns@denic.de

Homepage

The root servlet path of the NAST server.

Responses

Alive endpoint

Vital sign endpoint that indicates the life sign of the NAST server.

Responses

Readiness endpoint

Vital sign endpoint that indicates the NAST server is ready to serve API requests.

Responses

Metrics endpoint

Central endpoint serving latest NAST metrics regarding e.g. errors, warning, requests etc.

Responses

Predelegation checks endpoint for NAST legacy API v1 (deprecated)

Legacy endpoint performing predelegation checks for a given domain on API v1 scope (deprecated). Please use API v2 /v2/check/{domainname} for future purposes.

path Parameters

result_format required	string Enum: "xml" "json" Response body format
domainname required	string (domain_name) <= 255 characters ^(?!\.)(?!.*?\.\.)[\-\.A-Za-z0-9áàăâåäãąāæćĉč... Domain name

query Parameters

ns1 required	string (nameserver_with_optional_ip) ^(?!\.)(?!.*?\.\.)[\-\.A-Za-z0-9áàăâåäãąāæćĉč... Examples: ns1=ns1.denic.nast. - Sample with nameserver only ns1=ns1.denic.nast.,172.31.1.1,fd00:10:10::1:1 - Sample with nameserver plus optional IPs Comma-separated string containing the nameserver with optional ip addresses
ns2 required	string (nameserver_with_optional_ip) ^(?!\.)(?!.*?\.\.)[\-\.A-Za-z0-9áàăâåäãąāæćĉč... Examples: ns2=ns2.denic.nast. - Sample with nameserver only ns2=ns2.denic.nast.,172.31.2.2,fd00:10:10::2:2 - Sample with nameserver plus optional IPs Comma-separated string containing the nameserver with optional ip addresses
policy	string Enum: "DE-DNSSEC-1.0" "DE-NO-DNSSEC-1.0" Enables DNSSEC predelegation checks
nsX	Array of strings (nameserver_with_optional_ip) Example: nsX=ns3.denic.nast.,172.31.3.3,fd00:10:10::3:3&nsX=ns4.denic.nast.,172.31.4.4,fd00:10:10::4:4&nsX=ns5.denic.nast. Additional list of further nameservers with optional ip addresses
dnskey	Array of strings (dnskey_wire_text) Example: dnskey=257 3 15 TTVxWTUvVUxrSHBCdE4reC9zVzVEQ05NRHJ4UnowTE9qUmVQS3dTRmlBPT0=&dnskey=257 3 16 dHlOQUVsMjlEUWpiVjR5Uk14OXBxbVpTMHpSeWR0U09UV1pYNVpWdy81bzdwNGRkcEpWTElvemc0WmMrQWtBRUhHSlFFK3YxWEtvPQ== List of base64 encoded public dnskeys in wire-text format
debug	boolean Enum: true false Additional debug output for predelgation checks

Responses

Response samples

200

Content type

application/json

{"success": true,
"issues": [{"arguments": ["string"
],
"code": 0,
"message": "string",
"severity": "info"
}
]
}

Nameserver resolver endpoint for NAST API v2

Major endpoint resolving nameservers for a given domain on API v2 scope.

path Parameters

domainname

required

string (domain_name) <= 255 characters ^(?!\.)(?!.*?\.\.)[\-\.A-Za-z0-9áàăâåäãąāæćĉč...

Domain name

Responses

Response samples

200
404

Content type

application/json

{"dnskey": [{"algorithm": 1,
"flags": 256,
"protocol": 3,
"key": "string"
}
],
"domainname": "string",
"nameserver": {"property1": ["string"
],
"property2": ["string"
]
}
}

Predelegation checks endpoint for NAST API v2

Major endpoint performing predelegation checks for a given domain on API v2 scope.

path Parameters

domainname

required

string (domain_name) <= 255 characters ^(?!\.)(?!.*?\.\.)[\-\.A-Za-z0-9áàăâåäãąāæćĉč...

Example: denic.nast

Domain name

query Parameters

ns1 required	string (nameserver_with_optional_ip) ^(?!\.)(?!.*?\.\.)[\-\.A-Za-z0-9áàăâåäãąāæćĉč... Examples: ns1=ns1.denic.nast. - Sample with nameserver only ns1=ns1.denic.nast.,172.31.1.1,fd00:10:10::1:1 - Sample with nameserver plus optional IPs Comma-separated string containing the nameserver with optional ip addresses
ns2 required	string (nameserver_with_optional_ip) ^(?!\.)(?!.*?\.\.)[\-\.A-Za-z0-9áàăâåäãąāæćĉč... Examples: ns2=ns2.denic.nast. - Sample with nameserver only ns2=ns2.denic.nast.,172.31.2.2,fd00:10:10::2:2 - Sample with nameserver plus optional IPs Comma-separated string containing the nameserver with optional ip addresses
nsX	Array of strings (nameserver_with_optional_ip) Example: nsX=ns3.denic.nast.,172.31.3.3,fd00:10:10::3:3&nsX=ns4.denic.nast.,172.31.4.4,fd00:10:10::4:4&nsX=ns5.denic.nast. Additional list of further nameservers with optional ip addresses
dnskey	Array of strings (dnskey_wire_text) Example: dnskey=257 3 15 TTVxWTUvVUxrSHBCdE4reC9zVzVEQ05NRHJ4UnowTE9qUmVQS3dTRmlBPT0=&dnskey=257 3 16 dHlOQUVsMjlEUWpiVjR5Uk14OXBxbVpTMHpSeWR0U09UV1pYNVpWdy81bzdwNGRkcEpWTElvemc0WmMrQWtBRUhHSlFFK3YxWEtvPQ== List of base64 encoded public dnskeys in wire-text format
debug	boolean Enum: true false

Responses

Response samples

200

Content type

application/json

{"success": true,
"issues": [{"arguments": {"property1": "string",
"property2": "string"
},
"code": 0,
"message": "string",
"severity": "info"
}
]
}