Intelligent DNS

Edite no GitHub

Utilize a API do Intelligent DNS para criar, consultar e atualizar suas Hosted Zones e Records.

  1. Consultar lista de Hosted Zones
  2. Consultar dados de uma Hosted Zone
  3. Criar uma nova Hosted Zone
  4. Consultar lista de Records por Hosted Zones
  5. Criar um novo Record

1. Consultar lista de Hosted Zones

Retorna a lista de Hosted Zones.

GET /intelligent_dns

Permissão necessária: View Intelligent DNS

Parâmetros obrigatórios

Parâmetro Descrição Tipo Tipo de Dado
Authorization (obrigatório) A autenticação por Token previamente criado através do endpoint de Criação de Token header string
Accept Informações sobre o tipo de retorno e versão header string;

obrigatório: application/json;version=3

Exemplo de Requisição

GET /intelligent_dns 
Accept: application/json; version=3
Authorization: token ec6aabdc0b6bbeed826a36d8731630e36b6e3f22

Exemplo de Resposta

{
    "count": 2,
    "total_pages": 1,
    "schema_version": 3,
    "links": {
        "previous": null,
        "next": null
    },
    "results": [
        {
            "is_active": true,
            "domain": "mydomain.com",
            "name": "Domain Criado via API",
            "id": 1
        },
        {
            "is_active": true,
            "domain": "domain.com",
            "name": "Domain Criado via RTM",
            "id": 2
        }
    ]
}

2.Consultar dados de uma Hosted Zone

Retorna detalhes de uma Hosted Zone.

GET /intelligent_dns/:id

Permissão necessária: View Intelligent DNS

Parâmetros obrigatórios

Parâmetro Descrição Tipo Tipo de Dado
Authorization (obrigatório) A autenticação por Token previamente criado através do endpoint de Criação de Token header string
Accept Informações sobre o tipo de retorno e versão header string;

obrigatório: application/json;version=3
:id (obrigatório) O id da hosted zone que se pretende consultar. path number

Exemplo de Requisição

GET /intelligent_dns/111
Accept: application/json; version=3
Authorization: token cf2078926f91a6e638af3f4a6977b505edfe5942

Exemplo de Resposta

{
    "results": {
        "expiry": 1209600,
        "id": 111,
        "is_active": true,
        "domain": "mydomain.com",
        "name": "Hosted Zone criado pela API",
        "nameservers": [
            "ns1.aziondns.net",
            "ns2.aziondns.com"
        ],
        "nx_ttl": 3600,
        "refresh": 43200,
        "retry": 7200,
        "soa_ttl": 3600
    },
    "schema_version": 3
}

3.Criar uma nova Hosted Zone

Possibilita a criação de uma nova Hosted Zone.

POST /intelligent_dns

Permissão necessária: Edit Intelligent DNS

Parâmetro Descrição Tipo Tipo de Dado
Authorization (obrigatório) A autenticação por Token previamente criado através do endpoint de Criação de Token header string
Accept Informações sobre o tipo de retorno e versão header string;

obrigatório: application/json;version=3
Content-Type (obrigatório) O tipo de codificação utilizada no Body (application/json).

ex.:

Content-Type: application/json
header string

Exemplo de Requisição

POST /intelligent_dns
Accept: application/json; version=3
Authorization: token cf2078926f91a6e638af3f4a6977b505edfe5941
Content-Type: application/json
{
    "name": "Hosted Zone criado pela API",
    "domain": "meudomain.com",
    "is_active": true
}

Exemplo de Resposta

{
    "results": {
        "domain": "meudomain.com",
        "expiry": 1209600,
        "id": 1,
        "is_active": true,
        "name": "Hosted Zone criado pela API",
        "nameservers": [
            "ns1.aziondns.net",
            "ns2.aziondns.com"
        ],
        "nx_ttl": 3600,
        "refresh": 43200,
        "retry": 7200,
        "soa_ttl": 3600
    },
    "schema_version": 3
}

4. Consultar lista de Records por Hosted Zones

Retorna a lista de Records da Hosted Zone.

GET /intelligent_dns/:id/records

Permissão necessária: View Intelligent DNS

Parâmetros obrigatórios

Parâmetro Descrição Tipo Tipo de Dado
Authorization (obrigatório) A autenticação por Token previamente criado através do endpoint de Criação de Token header string
Accept Informações sobre o tipo de retorno e versão header string;

obrigatório: application/json;version=3
:id (obrigatório) O id da hosted zone que se pretende consultar. path number

Exemplo de Requisição

GET /intelligent_dns/111/records
Accept: application/json; version=3
Authorization: token cf2078926f91a6e638af3f4a6977b505edfe5942

Exemplo de Resposta

{
   "count": 1,
   "links": {
       "previous": null,
       "next": null
   },
   "total_pages": 1,
   "schema_version": 3,
   "results": {
       "records": [
           {
               "record_type": "ANAME",
               "ttl": 3600,
               "answers_list": [
                   "123456a.ha.azioncdn.net"
               ],
               "entry": "@"
           }
       ],
       "zone_id": 111,
       "zone_domain": "meudomain.com"
   }
}

5. Criar um novo Record

Possibilita a criação de um Record vinculado à uma Hosted Zone.

POST /intelligent_dns/records

Permissão necessária: Edit Intelligent DNS

Parâmetro Descrição Tipo Tipo de Dado
Authorization (obrigatório) A autenticação por Token previamente criado através do endpoint de Criação de Token header string
Accept Informações sobre o tipo de retorno e versão header string;

obrigatório: application/json;version=3
Content-Type (obrigatório) O tipo de codificação utilizada no Body (application/json).

ex.:

Content-Type: application/json
header string

Exemplo de Requisição

POST /intelligent_dns/records
Accept: application/json; version=3
Authorization: token cf2078926f91a6e638af3f4a6977b505edfe5941
Content-Type: application/json
{
    "zone_id": 1,
    "record_type": "ANAME",
    "entry": "@",
    "answers_list": [
        "123456a.ha.azioncdn.net",
        "245678a.ha.azioncdn.net"
    ],
    "ttl": 3600
}

Exemplo de Resposta

{
   "results": {
       "zone_id": 1,
       "record_type": "ANAME",
       "entry": "@"
       "answers_list": [
           "123456a.ha.azioncdn.net",
           "245678a.ha.azioncdn.net",
       ],
       "ttl": 3600,
   },
   "schema_version": 3
}

Não encontrou o que procurava? Abra um ticket.