live.imgcheck
Use this method to submit a photo to the moderation service. It will return an photo ID that is used to return the results of the moderation to a callback function.
You may also use the WP sandbox for testing and development: webpurify.sandbox.imgcheck
After your photo has been moderated, the resulting status can be reported using one of our response methods. See our moderation results documentation
Arguments
api_key
(Required)- Your API application key.
imgurl
(Required) (max: 65,000 characters)- Full url to the photo you would like moderated.
format
(Optional) (max: 65,000 characters)- Response format: xml or json. Defaults to xml.
customimgid
(Optional) (max: 65,000 characters)- A custom ID you wish to associate with the photo that will be carried through to the callback.
callback
(Optional) (max: 65,000 characters)- You may also submit a URL encoded callback on a per photo basis: read more
snstopic
(Optional)- SNS Topic name. To use AWS SNS to receive results read more
photodna
(Optional)- Set = 1 to check photos for matches against known child exploitation hash datasets – You must activate PhotoDNA for your API Key in your admin console. Click here for more information on WebPurify’s PhotoDNA integration
Example Response
<?xml version="1.0" encoding="utf-8" ?> <rsp stat="ok"> <method>webpurify.live.imgcheck</method> <format>rest</format> <imgid>7de93bc200ff21a26da6ddb115506e82</imgid> <status>pending</status> <api_key>f3412a9614845dc17d97a5d51axxxx</api_key> </rsp>
Error Codes
100: Invalid API Key
- The API key passed was not valid.
101: API Key is inactive
- The API key passed is inactive or has been revoked.
102: API Key was not included in request
- This method requires an API Key.
103: Not a valid URL
- The submitted URL is not valid.
106: Out of Requests
- Out of Requests, Please refill.