Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Get information about listed ip-addresses. A POST request is required for this to work (officially). However, one (unsupported) command does the same: /3.0/dnsbl/request/ip/<address>

Parameters

ParameterDescription
ipAddress list (arrays allowed)
flags

Array or associative array containing special requests. For example:

Code Block
{
  "flags":["resolve"]
}

Adding a resolve-flag to the request will generate another output in the response array, with the resolved hostname in the blacklist.

Examples

Code Block
languagejs
titleRequest
{"ip":["44.11.12.77","18.33.14.30"]}

...

No. Not in the current state. As the system is based on DNS requests, such API calls would fill the database with way too much information.

Flags

It is possible to add extra flags to some requests (as mentioned above). For example, to get a "getListed"-response with the resolved hosts of the blacklisted addresses, you can for example send a request like this:

Code Block
{
    "ip":"67.212.160.0/19",
    "flags":["resolve"]
}

The output response will in this case transform into:

Code Block
{
	"dnsblResponse": [{
		"ip": "67.212.167.146",
		"typebit": "84",
		"discovered": "2018-03-18 11:07:18",
		"typestring": "phishing",
		"deleted": "0000-00-00 00:00:00",
		"lastchange": "2018-03-18 11:07:18",
		"hostname": "server2.himmelstein.com",
		"resolved": "1521368263",
		"hasResolveFlag": "1",
		"resolve": "server2.himmelstein.com",
		"lastResolve": "server2.himmelstein.com",
		"lastResolveTime": "1521368263",
		"constants": [
			"IP_PHISHING",
			"IP_MAILSERVER_SPAM",
			"IP_ABUSE_NO_SMTP"
		]
	}]
}

Where hasResolveFlag set to 1 (true) to tell the remote requester that the boths keys resolve and lastResolve will contain a resolved hostname of the ip-address. The resolve-key is a realtime hostname resolve of the ip-addresser and the lastResolve-key indicates what hostname the address had the last time it was resolved in unix timestamp formatting (hosts are periodically checked this way as a way to handle special whitelisting cases). The unix timestamp are returned in the key lastResolveTime.

Exceptions

When the API find no blacklisted hosts

...