Cognable

SOAP Service

List of service parameters and their possible values follow; see the WSDL or PHP samples for more information.

• $code : Captcha text. A case insensitive, alphanumeric string of maximum length 20 characters.
• $mode : one of 'simple', 'phonetic', 'both' or 'animal'.
• $language : either 'UK-English' or 'US-English'.
• $obfuscate : TRUE or FALSE. Disguise the audio.
• $prefix : TRUE or FALSE. Add a random prefix to the audio.
• $extend : TRUE or FALSE. Extend the lifespan to 30 minutes from 3 minutes.
• $count : TRUE or FALSE. Add a prefix which announces the number of Captcha characters.

Output

The url of the Captcha audio as an mp3 is returned, this will be in the form "http://captcha.cognable.com/captcha/xxxxxx/captcha.mp3". By default the Captcha mp3 is kept available for 3 minutes after generation, beyond this an audio message asking the user to refresh the Captcha will be provided. You can optionally extend the life of the Captcha to 30 minutes, which may be useful if its to be used on complex, time-consuming forms for instance.