GET - GET a specific NAPTR Record by ID

Purpose

This API call is used to retrieve the details of a specific NAPTR (Naming Authority Pointer) DNS record including all service entries and routing rules from a DNS zone in DDI Central. NAPTR records are essential for advanced service discovery use cases such as VoIP (SIP/H.323) and ENUM, where they define how domain names are translated into URIs or service records using regular expressions.

Request URL

Method: GET

https://{appconsole_IP}:{9443}/api/dhcp/zone/{zone_pk}/DS/{pk}/

Request Headers

The following headers must be included in the API request for successful authentication and data submission:

Authorization: DDI Central's OAuth implementation uses the Bearer authentication scheme. Hence, while making API calls, access_token obtained via the OAuth 2.0 Client Credentials Grant must be included in the Authorization header of API requests. This token verifies the client’s identity and ensures appropriate permissions for accessing resources.

The Authorization Header follows the format below:

headers = { "Authorization": "Bearer {bearer_tk}" }


Content-Type: Required in the header to indicate the media type of the resource being sent. It helps the server at the receiving end understand how to process the transmitted request body.

The Content-Type Header follows the format below:

headers ={ "Content-Type": "application/json" }

Path Parameters

  • zone_pk*  long
    • The primary key of the DNS zone containing the NAPTR record to be retrieved.
  • pk*  long
    • The unique identifier (primary key) of the specific NAPTR record to retrieve.

 

* - Mandatory parameter.

 

Sample Response

Copied
{
    "naptr_domain_id": 112,
    "zone_id": 12145,
    "domain_name": "na94.green.com.",
    "domain_ttl": 86400,
    "zone_name": "green.com.",
    "cluster_name": "chennai2",
    "records": [
        {
        "order": 13,
        "preference": 10,
        "flag": "U",
        "service": "E2U+h323",
        "regexp": "!^.*$!sip:customer-service@green.com!",
        "replacement": "green.com."
        },
        {
        "order": 14,
        "preference": 11,
        "flag": "S",
        "service": "E2U+email",
        "regexp": "!^.*$!sip:consumer-service@green.com!",
        "replacement": "green.com."
        }
    ]
}