validmail
      Zurück zur Startseite
      1. Help Center
      2. validmail

      Spam traps

      Address spam trap check

      The check tests whether the address provided is known as a spam trap:

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

      Result

      <spamtrapStatus> 
       <infoId>foo@bar.com</infoId> 
       <result>1</result> 
       <trapType>1</trapType> 
      </spamtrapStatus>

      or

      {"infoId": "foo@bar.com", "result": 1}

      The result document contains:

      • result: the evaluation result
        • 0: address is not a known spam trap
        • 1: address is a known spam trap
      • infoId: if the result is 1, this field contains the ID for looking up more information about a spam trap resource.
      • trapType: the kind of spam trap found
      • 0: not a known spam trap
      • 1: the email address, the mailbox is a known spam trap
      • 2: the domain of the email address is a known spam trap

      Functionality

      The service tests the address against the contents of the configured data source. If there is a match it returns a positive result and the resource ID of the spam trap that matched.

      Information about a spam trap resource

      The botrisk info API call returns information about spam trap resources.

      Syntax /svc/2.0/info/spamtrap/<id>
      Example /svc/2.0/info/spamtrap/foo@bar.com
      Parameter An ID (string) as the last part of the URL

      Result

      <spamtrapInfo> 
       <id>foo@bar.com</id> 
       <trapType>1</trapType> 
       <owner>Spamtrap ... GmbH</owner> 
       <remarks>Sending to spam traps of this kind leads to the following reactions ...</remarks> 
       <url>spam110trap.de/x1</url> 
      </spamtrapInfo>

      or

      { 
       "id":"foo@bar.com", 
       "trapType":1, 
       "owner":"Spamtrap ... GmbH", 
       "remarks":"Sending to spam traps of this kind leads to the following reactions ...", 
       "url":"spam110trap.de/x1" 
      }

      The structure of the result document is:

      • id: resource ID
      • trapType: scope/kind of spam trap
        • 1: single email address
        • 2: a domain
      • owner: the name of the maintaining entity, if known
      • remarks: details about the resource
      • url: a URL with more informtion about the provider, reactions

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