Resource path: /captcha
Returns a path to a verification image and a key to go with it. Users type the key embedded in the image, which is then sent back to the API server for verification. The captcha image may be used standalone, and is also embedded with the creation of a new user or a new subscription resource.
<?xml version="1.0" encoding="utf-8" ?> <feedblitzapi version="1.0" xmlns:xlink="http://www.w3.org/1999/xlink"> <rsp stat="ok"> <success code="0" msg="Authorized" /> </rsp> <captcha> <random>123</random> <img>http://feedblitz.com/an_image_file</img> <response>what_the_user_typed</response> </captcha> </feedblitzapi>
When used with a GET the <response> tag is not returned. To validate a user’s response, post the <random> and the <response> tags to the resource (the <img> tag is not required). If it validates, the <rsp> tag from the POST will be OK. If not, a new <captcha> will be served back to you to be re-presented to the user.
You may use the /captcha resource standalone to validate a user is not a machine, as well as using it embedded in the /user resources as described below.