Requests

New request

Registers a new batch request for the given domains. You can use the returned id in a status request to track progress.

A note on the domain list: After the initial validation of the domains' name, domains are used as-is. No extra logic is used to produce more test targets e.g, web testing the bare and the www version of a domain requires both domain names to be present in the domain list.

post/requests

Request

  • The document declares no server URL.
  • Auth
    HTTP basic

Request body

type'web' | 'mail' required
namestring

A free form string that only serves as a reference for the requester. Does not need to be unique.

domainsstring[] required

List of domains to test.

Example request

{
  "name": "Web test - 1/1/1970",
  "domains": [
    "internet.nl",
    "batch.internet.nl",
    "dashboard.internet.nl",
    "nic.商标"
  ]
}

Response

Success

api_versionstring required

Example response

{
  "api_version": "2.0.0",
  "request": {
    "request_id": "e94251da69c54da7b16fc5202a69c5c2",
    "name": "Web test - 1/1/1970"
  }
}

Changes

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