It can happen that an API request returns an error. In this article, we’ll show you how a response with an error looks like, and the meaning of the most common errors received so you can troubleshoot them easily.
Below is an example of an API request with an invalid video ID:
"message": "Can't find object video for `id' parameter",
These informations can help you identify the issue with your call and troubleshoot it easily.
In this article, you’ll find the list of the most common error codes, error types and video access errors.
The Dailymotion Platform API uses conventional HTTP response codes to indicate success or failure of an API request:
2xxrange indicates success
4xxrange indicates an error resulting from invalid provided information (e.g. a required parameter is missing, invalid access token, etc.)
5xxrange indicates an error with the Dailymotion servers
|HTTP error code
|Corresponding Dailymotion errors
400 Bad Request
|The API call requires authentication but it was not presented or was wholly invalid, or the API call was invalid
|A valid access token should be provided. This error may come from an expired access token.
|The request is understood but has been denied, or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to spam activity, or the request requires higher privileges than provided by the access token.
404 Not Found
|The requested object was not found (can also be thrown when you request non active users, censored videos, etc.).
405 Method Not Allowed
|Invalid HTTP Method +
method_not_allowed error type.
500 Internal Server Error
|This API error covers any other type of problem (e.g.: a temporary problem with the Dailymotion servers) and should turn up only very infrequently. Check the associated message for more information.
501 Not Implemented
|The specified method does not exist
Here’s a list of error types you may encounter in errors returned by the API:
|Thrown when the user doesn’t have the permission to access the data (e.g. missing a required scope to access certain fields)
|The requested object has been deleted
|The API endpoint or object connection is invalid
|Your request contains invalid parameters (e.g. you set an invalid data type for a field)
|The API call is correct, but the method is not allowed (e.g.: replace a video URL before encoding process is over)
|You forgot a required parameter in your API call
|The requested object was not found
|The data you tried to set using the API could not be saved, this is generally a temporary error that will resolve itself over time
When requesting access to a video, the API may return a message in the
access_error field explaining why the access can’t be granted. Here are the different access error codes you may encounter:
|No video has been specified, you need to specify one.
|Content has been deleted.
|Live content is not available, i.e. it may not have started yet.
|Copyrighted content, access forbidden.
|Publishing in progress…
|Video geo-restricted by its owner.
|Explicit content (offsite embed)
|An encoding error occurred
|Encoding in progress
|This video has no preset (no video stream)
|This video has not been made available on your device by its owner
|Kids host error
|Content not available on this website, it can only be watched on Dailymotion
|This content has been uploaded by an inactive channel and its access is limited