GUguardllamanet
filtering

Check if host name is filtered

get/filtering/check_host

Request

  • Base URL
    /control (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    HTTP basic

Query parameters

namestring

Filter by host name

Response

OK.

reason'NotFilteredNotFound' | 'NotFilteredWhiteList' | 'NotFilteredError' | 'FilteredBlackList' | 'FilteredSafeBrowsing' | 'FilteredParental' | 'FilteredInvalid' | 'FilteredSafeSearch' | 'FilteredBlockedService' | 'Rewrite' | 'RewriteEtcHosts' | 'RewriteRule'

Request filtering status.

filter_idinteger

In case if there's a rule applied to this DNS request, this is ID of the filter list that the rule belongs to. Deprecated: use rules[*].filter_list_id instead.

rulestring

Filtering rule applied to the request (if any). Deprecated: use rules[*].text instead.

service_namestring

Set if reason=FilteredBlockedService

cnamestring

Set if reason=Rewrite

ip_addrsstring[]

Set if reason=Rewrite

Example response

{
  "reason": "NotFilteredNotFound",
  "filter_id": 0,
  "service_name": "service_name",
  "cname": "cname",
  "rule": "||example.org^",
  "rules": [
    {
      "text": "||example.org^",
      "filter_list_id": 123123
    },
    {
      "text": "||example.org^",
      "filter_list_id": 123123
    }
  ],
  "ip_addrs": [
    "ip_addrs",
    "ip_addrs"
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.