1 of 20
2 of 20
3 of 20
4 of 20
5 of 20
6 of 20
7 of 20
8 of 20
9 of 20
10 of 20
11 of 20
12 of 20
13 of 20
14 of 20
15 of 20
16 of 20
17 of 20
18 of 20
19 of 20
20 of 20

site

doc

blog

success stories

Intelligent DNS

Edite no GitHub

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

  1. Obter lista de Hosted Zones
  2. Obter dados de uma Hosted Zone
  3. Criar uma nova Hosted Zone
  4. Editar uma Hosted Zone
  5. Deletar uma Hosted Zone
  6. Obter lista de Records por Hosted Zones
  7. Criar um novo Record
  8. Editar um Record
  9. Deletar um Record

1. Obter lista de Hosted Zones

Retorna a lista de Hosted Zones.

GET /intelligent_dns

Permissão necessária: View 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
*obrigatório
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. Obter dados de uma Hosted Zone

Retorna detalhes de uma Hosted Zone.

GET /intelligent_dns/:id

Permissão necessária: View 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
*obrigatório
Informações sobre o tipo de retorno e versão. header string;

obrigatório: application/json;version=3
:id
*obrigatório
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
*obrigatório
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).

Exemplo:
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. Editar uma Hosted Zone

Permite modificar uma Hosted Zone já criada.

PUT /intelligent_dns/:zone_id

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
*obrigatório
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).

Exemplo:
Content-Type: application/json
header string
:zone_id
*obrigatório
ID de uma Hosted Zone criada anteriormente. path number

Exemplo de Requisição

PUT /intelligent_dns/111
Accept: application/json; version=3
Authorization: token cf2078926f91a6e638af3f4a6977b505edfe5941
Content-Type: application/json

{
    "name": "Hosted Zone Editada pela API",
    "domain": "mydomain.com",
    "is_active": true
}

Exemplo de Resposta

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

5. Deletar uma Hosted Zone

Permite deletar um Hosted Zone já criada.

DELETE /intelligent_dns/:zone_id

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
*obrigatório
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).

Exemplo:
Content-Type: application/json
header string
:zone_id
*obrigatório
ID de uma Hosted Zone criada anteriormente. path number

Exemplo de Requisição

DELETE /intelligent_dns/111/records/333
Accept: application/json; version=3
Authorization: token cf2078926f91a6e638af3f4a6977b505edfe5941

Exemplo de Resposta

HTTP/2 204

6. 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
*obrigatório
Informações sobre o tipo de retorno e versão header string;

obrigatório: application/json;version=3
:id
*obrigatório
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": "@",
               "policy": "simple",
               "description": ""
           }
       ],
       "zone_id": 111,
       "zone_domain": "meudomain.com"
   }
}

7. Criar um novo Record

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

POST /intelligent_dns/:zone_id/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
*obrigatório
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).

Exemplo:
Content-Type: application/json
header string
:zone_id
*obrigatório
ID de uma Hosted Zone criada anteriormente. path number

Exemplo de Requisição

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

Exemplo de Resposta

{
   "results": {
       "zone_id": 111,
       "id": 333,
       "record_type": "ANAME",
       "entry": "@"
       "answers_list": [
           "123456a.ha.azioncdn.net"
       ],
       "ttl": 20,
       "policy": "simple",
       "description": "",
   },
   "schema_version": 3
}

8 - Editar um Record

Permite modificar um Record já criado.

PUT /intelligent_dns/:zone_id/records/:record_id

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
*obrigatório
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).

Exemplo:
Content-Type: application/json
header string
:zone_id
*obrigatório
ID de uma Hosted Zone criada anteriormente. path number
:record_id
*obrigatório
ID de um Record criado anteriormente. path Number

Exemplo de Requisição

PUT /intelligent_dns/111/records/333
Accept: application/json; version=3
Authorization: token cf2078926f91a6e638af3f4a6977b505edfe5941
Content-Type: application/json

{
    "record_type": "CNAME",
    "entry": "www",
    "answers_list": [
        "123456a.ha.azioncdn.net"
    ],
    "ttl": 3600,
    "policy": "weighted",
    "weight": 60,
    "description": "Florida Load Balancer"

Exemplo de Resposta

{
   "results": {
       "zone_id": 111,
       "id": 333,       
       "record_type": "CNAME",
       "entry": "www"
       "answers_list": [
           "123456a.ha.azioncdn.net"
       ],
       "ttl": 3600,
       "policy": "weighted",
       "weight": 60,
       "description": "Florida Load Balancer"
   },
   "schema_version": 3
}

Observação: o valor “weight” só irá ser usado se a “policy”escolhida for “weighted”. No caso de “simple” policy, esse valor será desconsiderado.

9. Deletar um Record

Permite deletar um Record vinculado à uma Hosted Zone já criada.

DELETE /intelligent_dns/:zone_id/records/:record_id

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 *obrigatório 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).

Exemplo:
Content-Type: application/json
header string
:zone_id
*obrigatório
ID de uma Hosted Zone criada anteriormente. path number
:record_id
*obrigatório
ID de um Record criado anteriormente path number

Exemplo de Requisição

DELETE /intelligent_dns/111/records/333
Accept: application/json; version=3
Authorization: token cf2078926f91a6e638af3f4a6977b505edfe5941

Exemplo de Resposta

HTTP/2 204

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