Pular para o conteúdo principal
GET
/
policy
/
{policyId}
Obter uma Política de DNS
curl --request GET \
  --url https://api.altostrat.io/policy/{policyId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "9a9a3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8a",
  "name": "Política Padrão para Funcionários",
  "applications": [
    "9a9b3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8b",
    "9a9c3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8c"
  ],
  "safe_search": [
    {
      "id": "9a9f3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8f",
      "option": "strict"
    }
  ],
  "dns_whitelist": [
    "internal.corp.com",
    "status.altostrat.io"
  ],
  "dns_blacklist": [
    "malicious-site.net"
  ],
  "block_adult": true,
  "attachments": 5,
  "created_at": "2025-10-29T13:04:44Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
policyId
string<uuid>
required

O identificador único da política de DNS.

Example:

"9a9a3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8a"

Response

A política de DNS solicitada.

​
id
string<uuid>

O identificador único para a política de DNS.

Example:

"9a9a3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8a"

​
name
string

Um nome legível por humanos para a política.

Example:

"Política Padrão para Funcionários"

​
applications
string<uuid>[]

Uma lista de IDs de aplicação a serem bloqueados por esta política.

Example:
[
  "9a9b3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8b",
  "9a9c3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8c"
]
​
safe_search
object[]

Uma lista de regras de imposição de Pesquisa Segura.

​
dns_whitelist
string<hostname>[]

Uma lista de nomes de domínio totalmente qualificados (FQDNs) para sempre permitir, sobrepondo quaisquer regras de bloqueio.

Example:
["internal.corp.com", "status.altostrat.io"]
​
dns_blacklist
string<hostname>[]

Uma lista de nomes de domínio totalmente qualificados (FQDNs) para sempre bloquear.

Example:
["malicious-site.net"]
​
block_adult
boolean

Se verdadeiro, bloqueia automaticamente todas as aplicações categorizadas como conteúdo adulto.

Example:

true

​
attachments
integer

O número de sites que estão usando esta política atualmente.

Example:

5

​
created_at
string<date-time>

O carimbo de data/hora de quando a política foi criada.

Example:

"2025-10-29T13:04:44Z"