Errors

All function calls to the Web Service can possibly return an error if a problem occurs while processing your request. When a problem happens, an error code is returned in XML format, like this:

<?xml version="1.0" encoding="utf-8" ?>
<nimbb version="1">
<error>
  <code>2</code>
  <message>The credentials (key and code) are invalid or this account does not have an active subscription.</message>
  <url>http://api.nimbb.com/Video/Download.aspx</url>
</error>
</nimbb>

A message is also returned for quick understanding of the problem and the url that was called causing the error. After calling our API, it is good practice to verify that no error was returned by the service.

Here is the complete list of error codes:

Code Message Reason / Solution
1 Service is temporarily closed The service is currently offline and should get back online soon (usually in minutes).
2 Invalid credentials The credentials (key and code) are invalid or this account does not have an active subscription.
3 Invalid access Trying to access data not owned by your account.
4 Could not get data The service could not get expected data from our server. Verify your request URL and contact us if this problem persists.
5 Invalid or missing parameter Your function request is missing a required parameter or has an invalid value. Correct the request URL.
6 Invalid subscription type Your account's subscription type doesn't allow access to this function.
7 Invalid date format The date provided is not in a recognized format.
8 Invalid parameter value provided One of the parameter provided is invalid. Check that values are appropriate.
9 Access to HTTPS call refused A subscription of type Platinum or higher is required for SSL access.
10 Invalid video guid The video GUID provided is invalid.
11 Problem file access There was an error while trying to access the video file.
12 Video not active The video status is not set to active. You can't access it.
13 Can't generate thumbnail There was an error while trying to generate the thumbnail image for the video.
14 Can't delete video There was an error while trying to delete the video.
15 Can't move video There was an error while trying to move the video.
16 Invalid credentials The credentials (email and password) are invalid or this account does not have an active subscription.
17 Incompatible format Incompatible video format specified.
18 Unauthorized site access The authentification based on the public key and site URL is invalid. Verify your public key in your code and make sure that your site URL is defined in your Developer settings.
20 Amazon S3 error The Amazon S3 service returned an error.
21 Brightcove error The Brightcove service returned an error.
22 Access refused Access to the function is refused.
23 YouTube error Error while uploading to YouTube.
24 Vidyard error The Vidyard service returned an error.

Go back to Web Service documentation.
SIGN UP NOW 7-day free trial

Check out our Developer guide to get started with Nimbb.