“No Advertising” Household Check

The No Advertising address check’s purpose is to test whether an email address belongs to the list of registered no advertising households that should not be bothered with advertising information.

Syntax …/svc/2.0/address/no-advertising/<address>
Example …/svc/2.0/address/no-advertising/foo@bar.com
Parameter An ASCII email address as last part of the URL

Result

The service answers with a XML or JSON document providing the result code

XML:

<no-advertising>
  <result>1</result>
</no-advertising>

JSON:

{"result":1}

Possible result codes:

  • 0 - not found
  • 1 - found, the address belongs to a registered no advertising household.

Functionality

The service checks its input parameters against a list of no-advertising households that is provided by Nayoki. This list consists of encrypted (MD5) mail addresses. The service transforms the address into lower case, encrypts the input parameter with MD5 and compares the result with the Nayoki list.

If there is a match the service returns a positive answer, the address is included, else it answers negatively.

Each API call is logged as a business event with the ID 126.