Checks a CAPTCHA that was solved by the end-user.

        Keyword arguments:
        captcha_id -- Unique identifier of the CAPTCHA solved.
        solution -- Solution provided by the end-user for the CAPTCHA.
        author_name -- The name of the content author.
        author_url -- The homepage/website URL of the content author.
        author_mail -- The e-mail address of the content author.
        author_ip -- The IP address of the content author.
        author_id -- The local user ID on the client site of the content author.
        author_open_id -- List of Open IDs of the content author.
        honeypot -- The value of a client-side honeypot form element, if non-empty.
        
        Returns:
        solved -- Boolean whether or not the CAPTCHA was solved correctly. 
            If the CAPTCHA is associated with an unsure contents, it is recommended to recheck the content.

def check_captcha(self,
                      captcha_id,
                      solution,
                      author_name=None, 
                      author_url=None, 
                      author_mail=None, 
                      author_ip=None, 
                      author_id=None, 
                      author_open_id=None,
                      honeypot=None
                      ):
        """Checks a CAPTCHA that was solved by the end-user.

        Keyword arguments:
        captcha_id -- Unique identifier of the CAPTCHA solved.
        solution -- Solution provided by the end-user for the CAPTCHA.
        author_name -- The name of the content author.
        author_url -- The homepage/website URL of the content author.
        author_mail -- The e-mail address of the content author.
        author_ip -- The IP address of the content author.
        author_id -- The local user ID on the client site of the content author.
        author_open_id -- List of Open IDs of the content author.
        honeypot -- The value of a client-side honeypot form element, if non-empty.
        
        Returns:
        solved -- Boolean whether or not the CAPTCHA was solved correctly. 
            If the CAPTCHA is associated with an unsure contents, it is recommended to recheck the content.
        """
        check_catpcha_endpoint = Template("${rest_root}/captcha/${captcha_id}")
        url = check_catpcha_endpoint.substitute(rest_root=self._rest_root, captcha_id=captcha_id)
        
        data = {"solution": solution}
        
        response = self.__post_request(url, data)
        # Mollom returns "1" for success and "0" for failure
        return response["captcha"]["solved"] == "1"