Referência

This article contains documentation for AdGuard DNS API. For the complete AdGuard DNS API changelog, visit this page.

Current version: 1.10

/oapi/v1/account/limits

OBTER

Resumo

Gets account limits

Respostas

Código	Descrição
200	Informações sobre limites de conta

/oapi/v1/dedicated_addresses/ipv4

OBTER

Resumo

Lists dedicated IPv4 addresses

Respostas

Código	Descrição
200	Lista de endereços IPv4 dedicados

POST

Resumo

Allocates new IPv4

Respostas

Código	Descrição
200	Novo IPv4 atribuído com sucesso
429	Contagem de IPv4 dedicados atingiu o limite

/oapi/v1/devices

OBTER

Resumo

Lists devices

Respostas

Código	Descrição
200	Lista de dispositivos

POST

Resumo

Creates a new device

Respostas

Código	Descrição
200	Dispositivo criado
400	Falha na validação
429	A contagem de dispositivos atingiu o limite

/oapi/v1/devices/{device_id}

EXCLUIR

Resumo

Removes a device

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
device_id	path		Sim	linhas

Respostas

Código	Descrição
200	Dispositivo excluído
404	Dispositivo não encontrado

OBTER

Resumo

Gets an existing device by ID

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
device_id	path		Sim	linhas

Respostas

Código	Descrição
200	Informação do dispositivo
404	Dispositivo não encontrado

PUT

Resumo

Updates an existing device

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
device_id	path		Sim	linhas

Respostas

Código	Descrição
200	Dispositivo atualizado
400	Falha na validação
404	Dispositivo não encontrado

/oapi/v1/devices/{device_id}/dedicated_addresses

OBTER

Resumo

List dedicated IPv4 and IPv6 addresses for a device

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
device_id	path		Sim	linhas

Respostas

Código	Descrição
200	IPv4 e IPv6 dedicados

/oapi/v1/devices/{device_id}/dedicated_addresses/ipv4

EXCLUIR

Resumo

Unlink dedicated IPv4 from the device

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
device_id	path		Sim	linhas

Respostas

Código	Descrição
200	IPv4 dedicado desvinculado com sucesso do dispositivo
404	Dispositivo ou endereço não encontrado

POST

Resumo

Link dedicated IPv4 to the device

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
device_id	path		Sim	linhas

Respostas

Código	Descrição
200	IPv4 dedicado vinculado com sucesso ao dispositivo
400	Falha na validação
404	Dispositivo ou endereço não encontrado
429	A contagem de IPv4 dedicados vinculados atingiu o limite

/oapi/v1/devices/{device_id}/doh.mobileconfig

OBTER

Resumo

Gets DNS-over-HTTPS .mobileconfig file.

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
device_id	path		Sim	linhas
exclude_wifi_networks	consulta	Liste as redes Wi-Fi pelo SSID nas quais você deseja que o DNS do AdGuard seja desativado	Não	[ linha ]
exclude_domain	consulta	Listar domínios que utilizarão servidores DNS predefinidos em vez do AdGuard DNS	Não	[ linha ]

Respostas

Código	Descrição
200	Arquivo .plist DNS-over-HTTPS
404	Dispositivo não encontrado

/oapi/v1/devices/{device_id}/doh_password/reset

PUT

Resumo

Generate and set new DNS-over-HTTPS password

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
device_id	path		Sim	linhas

Respostas

Código	Descrição
200	Senha do DNS-over-HTTPS redefinida com sucesso
404	Dispositivo não encontrado

/oapi/v1/devices/{device_id}/dot.mobileconfig

OBTER

Resumo

Gets DNS-over-TLS .mobileconfig file.

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
device_id	path		Sim	linhas
exclude_wifi_networks	consulta	Liste as redes Wi-Fi pelo SSID nas quais você deseja que o DNS do AdGuard seja desativado	Não	[ linha ]
exclude_domain	consulta	Listar domínios que utilizarão servidores DNS predefinidos em vez do AdGuard DNS	Não	[ linha ]

Respostas

Código	Descrição
200	Arquivo .plist DNS-over-HTTPS
404	Dispositivo não encontrado

/oapi/v1/devices/{device_id}/settings

PUT

Resumo

Updates device settings

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
device_id	path		Sim	linhas

Respostas

Código	Descrição
200	Configurações do dispositivo atualizadas
400	Falha na validação
404	Dispositivo não encontrado

/oapi/v1/dns_servers

OBTER

Resumo

Lists DNS servers that belong to the user.

Descrição

Lists DNS servers that belong to the user. By default there is at least one default server.

Respostas

Código	Descrição
200	Lista de servidores DNS

POST

Resumo

Creates a new DNS server

Descrição

Creates a new DNS server. You can attach custom settings, otherwise DNS server will be created with default settings.

Respostas

Código	Descrição
200	Servidor DNS criado
400	Falha na validação
429	A contagem de servidores DNS atingiu o limite

/oapi/v1/dns_servers/{dns_server_id}

EXCLUIR

Resumo

Removes a DNS server

Descrição

Removes a DNS server. All devices attached to this DNS server will be moved to the default DNS server. Deleting the default DNS server is forbidden.

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
dns_server_id	path		Sim	linhas

Respostas

Código	Descrição
200	Servidor DNS excluído
404	Servidor DNS não encontrado

OBTER

Resumo

Gets an existing DNS server by ID

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
dns_server_id	path		Sim	linhas

Respostas

Código	Descrição
200	Informação do servidor DNS
404	Servidor DNS não encontrado

PUT

Resumo

Updates an existing DNS server

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
dns_server_id	path		Sim	linhas

Respostas

Código	Descrição
200	Servidor DNS atualizado
400	Falha na validação
404	Servidor DNS não encontrado

/oapi/v1/dns_servers/{dns_server_id}/settings

PUT

Resumo

Updates DNS server settings

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
dns_server_id	path		Sim	linhas

Respostas

Código	Descrição
200	Configurações do servidor DNS atualizadas
400	Falha na validação
404	Servidor DNS não encontrado

/oapi/v1/filter_lists

OBTER

Resumo

Gets filter lists

Respostas

Código	Descrição
200	Lista de filtros

/oapi/v1/oauth_token

POST

Resumo

Generates Access and Refresh token

Respostas

Código	Descrição
200	Token de acesso emitido
400	Parâmetros obrigatórios ausentes
401	Credenciais inválidas, token MFA ou token de atualização fornecidos

null

/oapi/v1/query_log

EXCLUIR

Resumo

Clears query log

Respostas

Código	Descrição
202	O registo de consultas foi apagado

OBTER

Resumo

Gets query log

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
time_from_millis	consulta	Tempo de em milissegundos (inclusivo)	Sim	longo
time_to_millis	consulta	Tempo até em milissegundos (inclusivo)	Sim	longo
dispositivos	consulta	Filtrar por dispositivos	Não	[ linha ]
países	consulta	Filtrar por países	Não	[ linha ]
empresas	consulta	Filtrar por empresas	Não	[ linha ]
status	consulta	Filtrar por status	Não	[ FilteringActionStatus]
categorias	consulta	Filtrar por categorias	Não	[ CategoryType]
pesquisa	consulta	Filtrar por nome de domínio	Não	linhas
limite	consulta	Limitar o número de registros a serem retornados	Não	integer
cursor	consulta	Cursor de paginação. Usar o cursor da resposta para paginar pelas páginas.	Não	linhas

Respostas

Código	Descrição
200	Registro de consultas

/oapi/v1/revoke_token

POST

Resumo

Revokes a Refresh Token

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
refresh_token	consulta	Atualizar token	Sim	linhas

Respostas

Código	Descrição
200	Atualizar token revogado

null

/oapi/v1/stats/categories

OBTER

Resumo

Gets categories statistics

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
time_from_millis	consulta	Tempo de em milissegundos (inclusivo)	Sim	longo
time_to_millis	consulta	Tempo até em milissegundos (inclusivo)	Sim	longo
dispositivos	consulta	Filtrar por dispositivos	Não	[ linha ]
países	consulta	Filtrar por países	Não	[ linha ]

Respostas

Código	Descrição
200	Estatísticas de categorias recebidas
400	Falha na validação

/oapi/v1/stats/companies

OBTER

Resumo

Gets companies statistics

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
time_from_millis	consulta	Tempo de em milissegundos (inclusivo)	Sim	longo
time_to_millis	consulta	Tempo até em milissegundos (inclusivo)	Sim	longo
dispositivos	consulta	Filtrar por dispositivos	Não	[ linha ]
países	consulta	Filtrar por países	Não	[ linha ]

Respostas

Código	Descrição
200	Estatísticas de empresas recebidas
400	Falha na validação

/oapi/v1/stats/companies/detailed

OBTER

Resumo

Gets detailed companies statistics

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
time_from_millis	consulta	Tempo de em milissegundos (inclusivo)	Sim	longo
time_to_millis	consulta	Tempo até em milissegundos (inclusivo)	Sim	longo
dispositivos	consulta	Filtrar por dispositivos	Não	[ linha ]
países	consulta	Filtrar por países	Não	[ linha ]
cursor	consulta	Cursor de paginação	Não	linhas

Respostas

Código	Descrição
200	Estatísticas detalhadas das empresas recebidas
400	Falha na validação

/oapi/v1/stats/countries

OBTER

Resumo

Gets countries statistics

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
time_from_millis	consulta	Tempo de em milissegundos (inclusivo)	Sim	longo
time_to_millis	consulta	Tempo até em milissegundos (inclusivo)	Sim	longo
dispositivos	consulta	Filtrar por dispositivos	Não	[ linha ]
países	consulta	Filtrar por países	Não	[ linha ]

Respostas

Código	Descrição
200	Estatísticas dos países recebidas
400	Falha na validação

/oapi/v1/stats/devices

OBTER

Resumo

Gets devices statistics

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
time_from_millis	consulta	Tempo de em milissegundos (inclusivo)	Sim	longo
time_to_millis	consulta	Tempo até em milissegundos (inclusivo)	Sim	longo
dispositivos	consulta	Filtrar por dispositivos	Não	[ linha ]
países	consulta	Filtrar por países	Não	[ linha ]

Respostas

Código	Descrição
200	Estatísticas de dispositivos recebidas
400	Falha na validação

/oapi/v1/stats/domains

OBTER

Resumo

Gets domains statistics

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
time_from_millis	consulta	Tempo de em milissegundos (inclusivo)	Sim	longo
time_to_millis	consulta	Tempo até em milissegundos (inclusivo)	Sim	longo
dispositivos	consulta	Filtrar por dispositivos	Não	[ linha ]
países	consulta	Filtrar por países	Não	[ linha ]

Respostas

Código	Descrição
200	Estatísticas de domínios recebidas
400	Falha na validação

/oapi/v1/stats/time

OBTER

Resumo

Gets time statistics

Parâmetros

Nome	Localizado em	Descrição	Obrigatório	Esquema
time_from_millis	consulta	Tempo de em milissegundos (inclusivo)	Sim	longo
time_to_millis	consulta	Tempo até em milissegundos (inclusivo)	Sim	longo
dispositivos	consulta	Filtrar por dispositivos	Não	[ linha ]
países	consulta	Filtrar por países	Não	[ linha ]

Respostas

Código	Descrição
200	Estatísticas de tempo recebidas
400	Falha na validação

/oapi/v1/web_services

OBTER

Resumo

Lists web services

Respostas

Código	Descrição
200	Lista de serviços Web