Address Robinson List check

The Robinson List check tests whether teh address provided is registered in Robinson Lists.

Syntax…/svc/2.0/address/robinsonlist/<address>
Example…/svc/2.0/address/robinsonlist/foo@bar.com
ParameterAn ASCII email address as last part of the URL

Result

<robinsonlistStatus>
    <infoIds>
        <infoId>ecg-liste</infoId>
    </infoIds>
    <result>1</result>
</robinsonlistStatus>

or

{"infoIds": ["ecg-liste"], "result": 1}

The service looks for typical naming patterns in different parts of the address and returns the sum. The result document contains:

  • result: the evaluation result
    • 0: address is not part of any of the configured Robinson lists
    • 1: address is part of at least one of the configured Robinson lists
  • infoIds: if the result is > 0, this contains IDs for looking up more information about a Robinson resource.

Functionality

The service encrypts the email address and tests the result against the contents of the configured data sources. If there is a match it returns a positive result and the resource IDs of the lists that matched.

Each execution of the check will be documented as a business event (database table business_event) with type 104.

Information about a Robinson resource

The botrisk info API call returns information about botrisk resources. Bots can be identified by their naming patterns, which are documented here.

Syntax…/svc/2.0/info/robinsonlist/<id>
Example…/svc/2.0/info/robinsonlist/ecg-liste
ParameterAn ID (string) as the last part of the URL

Result

<robinsonlistInfo>
    <country>A</country>
    <id>ecg-liste</id>
    <name>ECG-Liste</name>
    <owner>RTR GmbH</owner>
    <remarks></remarks>
    <url>http://www.rtr.at/de/tk/E_Commerce_Gesetz</url>
</robinsonlistInfo>

or

{
  "country":"A",
  "name":"ECG-Liste",
  "id":"ecg-liste",
  "owner":"RTR GmbH",
  "remarks":"",
  "url":"http://www.rtr.at/de/tk/E_Commerce_Gesetz"
}

The structure of the result document is:

  • countryCode: country of list provider
  • name: Robinson List name
  • id: resource ID
  • owner: the name of the maintaining entity, if known
  • remarks: details about the resource
  • url: a URL with more informtion about the provider, list purpose

Functionality

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).

Each execution of the call will be documented as a business event (database table business_event) with type 105.