The IWT check tests whether an address belongs to a domain of an ISP, a Webmail or a Telecom provider.
Syntax | /svc/2.0/address/iwt/<address> |
Example | /svc/2.0/address/iwt/foo@bar.com |
Parameter | An ASCII email address as last part of the URL |
Result
<iwtStatus>
<infoId>bar.com</infoId>
<result>1</result>
</iwtStatus>
or
{"infoId": "bar.com", "result": 1}
The result details are:
- result: the evaluation result
- 0: the domain doesnt belong to known IWT provider
- 1: the domain belongs to known IWT provider
- infoId: if the result == 1, this contains the ID for looking up more information about a IWT resource
Functionality
If it matches a positive result is returned, which includes the ID for info lookup.
Information about a IWT resource
The IWT info API call returns information about various IWT resources, describing their market orientation and languages used.
Syntax | /svc/2.0/info/iwt/<ID> |
Example | /svc/2.0/info/iwt/bar.com |
Parameter | An info ID (domain name) as last part of the URL |
Result
<iwtInfo>
<id>bar.com</id>
<owner>Webmailer Corp.</owner>
<country>USA</country>
<orientation>1</orientation>
<languages>
<language>en</language>
</languages>
</iwtInfo>
or
{
"id": "bar.com",
"owner": "Webmailer Corp.",
"country“: "USA“,
"orientation“:1,
“languages“:["en"]
}
The result document contains:
- id: the ID of the resource, the domain name
- owner: the name of the owning entity, provider
- country: country name of the provider HQ
- orientation: market orientation
- 0: unknown
- 1: national
- 2: international
- languages: if the orientation is national (1) this field can contain 1-3 language codes (ISO 639-1/2) describing the languages used in that national market
Functionality
If successful (response code 200) the service will return a document with information about the requested IWT resource. If no data is available for an ID the server will signal this with HTTP response code 204 (No Content) and return no result (null).