You are here:

Softonic API

Error codes

Error code Error string HTTP response code
InvalidApiKey Invalid API key 403 - Forbidden
InvalidProApiKey The provided api key cannot use pro features. 403 - Forbidden
InvalidParameterValue Response format must be xml, json or php 404 - Not Found
InvalidParameterValue Invalid ID 404 - Not Found
ServerError Internal server error 500 - Internal Server Error

Error examples

Unknown URL request:
http://api2.softonic.com/en/unknown_method/abcd.xml?key=API_KEY

<?xml version="1.0"?>
<html>
  <body>API - 404</body>
</html>

Invalid URL request:
http://api2.softonic.com/en/correct_request/wrongParam.xml?key=API_KEY

<?xml version="1.0" encoding="UTF-8"?>
<response status="fail">
  <err code="InvalidParameterValue">Invalid ID</err>
</response>

The given API key does not support the requested method:
http://api2.softonic.com/en/pro_request/abcd.xml?key=API_KEY

<?xml version="1.0" encoding="UTF-8"?>
<response status="fail">
  <err code="403">The given API key does not support this method.</err>
</response>

Requested method needs a PRO API key:
http://api2.softonic.com/en/pro_request/abcd.xml?key=API_KEY

<?xml version="1.0" encoding="UTF-8"?>
<response status="fail">
  <err code="InvalidProApiKey">The provided api key cannot use pro features.</err>
</response>

Server error request:
http://api2.softonic.com/en/any_request/abcd.xml?key=API_KEY

<?xml version="1.0" encoding="UTF-8"?>
<response status="fail">
  <err code="ServerError">Internal server Error</err>
</response>