Quantcast
Channel: Video Cloud Overview Recent
Viewing all articles
Browse latest Browse all 2356

Media API Error Message Reference

$
0
0
-85

This is a reference to the error messages returned by the Media API, which include a numerical error code that classifies errors by type.

Error code numbering

Error messages returned by the Media API include a numerical error code that classifies errors by type:

Code RangeError Type
100–199system errors
200–299low-level user errors
300–399high-level (business logic) user errors

Error codes and messages

The following error messages can be returned by the Media API:

CodeNameMessageCause
100UnknownServer
Error
an unknown error occurred while processing your requestAn unspecified and unexpected error
101ServiceDeploying
Error
The write API is currently unavailable due to a scheduled upgrade. Please check http://studio.brightcove.com/ for updates.The Video Cloud Write API is currently down for a scheduled deployment.
102FileUploadErrorAn unexpected error occurred during file upload. Please try again.While using a Write API method, an IOException was encountered and the upload failed.
103CallTimeoutErrorThe request you made is taking longer than expected to return. If requesting a large amount of data please try again with a smaller page_size.Media API calls can time out before they complete if you are trying to get too much data at once. The page_size argument enables returning data in more manageable chunks.
200EnctypeErrorwrong enctype; write methods require a multipart/form-data POSTCalling a write method with a plain old POST
201GetRequiredErrormethods that retrieve data must be called using GET requestsCalling POST instead of GET on the Read API
202PostRequiredErrormethods that change data must be called using POST requestsCalling GET instead of POST on the Write API
203MissingQuery
StringError
no query string providedA missing query string in GET
204MissingBodyErrorPOST methods require valid JSON-RPC in the POST body, with "method" and "params" propertiesA missing parameter section in POST
205MalformedParameters
Error
unable to parse JSON-RPC parameters; they may be malformed or incorrectMalformed JSON in request
206InvalidMethodErrorinvalid method nameInvalid method name
207FilestreamRequired
Error
upload requires a multipart/form-data POST with a valid filestreamMissing file stream
208MissingFileName
Error
file for upload must have a filenameMissing file name
209UnwantedFilestream
Error
non-upload methods should not include a filestreamA filestream was provided for a non-upload method.
210InvalidTokenErrorinvalid tokenThe token used in the call is invalid.
211MissingJSONErrorCould not find JSON-RPC.We got a null string for either the json parameter (for a non-multipart post) or the first part of a multipart post.
213ConcurrentWrites
ExceededError
You have exceeded your number of concurrent write API calls. Please reduce the number of concurrent threads making write API calls.You have too many threads making write API calls at the same time. Modify your application so you do not have multiple threads making write API calls. Read Building Robust Applications in a Shared Environment for more information.
214ConcurrentReads
ExceededError
You have exceeded your number of concurrent read API calls. Please reduce the number of concurrent threads making read API calls.You have too many threads making unique read API calls at the same time. Modify your application so you do not have multiple threads making distinct read API calls. Read Building Robust Applications in a Shared Environment for more information.
301InvalidParameters
Error
parameters are the wrong type or number for this methodInvoking the method threw an IllegalArgumentException
302DeleteFailedError<message with reason for failure filled in by throwing method>Attempt to delete a business object failed. For example, attempts to delete a video that's in a manual playlist will fail.
303RequiredParameter
Error
required parameter <> was missing (<> to be filled in by throwing method)A required parameter was not set.
304IllegalValueError
  • Cannot find any video with id: <>
  • Cannot find the video you are trying to update: id <>
  • One or more accounts in sharee_account_ids are not enabled for media sharing
  • The referenceId property on this video is in use by a destination account.
  • In a get_upload_status call, the video_id entered does not refer to a valid video in the Media Library
  • In an update_video call, the video_id entered does not refer to a valid video in the Media Library
  • In a share_video call, you do not have a sharing relationship established with the account whose id was entered.
  • The reference ID is already in use in the destination account.
305IncompatibleValue
Error
  • The geo restriction property on this video is incompatible with the destination account.
  • The economics property on this video is incompatible with a destination account.
  • The settings in the video and the destination account don't match.
  • Advertising must be enabled on all accounts, or disabled on all accounts.
306FileFormatErrorThe provided file was not in the expected formatThe file provided to create_video was not in a supported file format.
307ObjectNotFound
Error
The object specified by the given parameters could not be found.The object with the specified id could not be found.
308Nonmatching
ChecksumError
The provided file's MD5 digest did not match the checksum provided.We checked an uploaded file's hash and it didn't match the expected checksum. Checksums are expected to include numbers and lowercase letters; make sure your checksum generator is not creating checksums with uppercase letters.
309RemoteAssets
DisabledError
This account is not approved to use remote assets.You attempted to create or update a remote asset, but your account is not enabled for this feature.
310InvalidCountryCode
Error
The following country codes are not supported for geo-restriction:You used an invalid country code for geo-restriction.
311GeoRestriction
DisabledError
This account is not approved to use geo-restriction.You attempted to set geo-restriction properties for a video, but your account is not enabled for this feature.
312ParameterConflict
Error
Two or more parameters passed to a method have incompatible values. <specific conflict if known>Two or more parameter values passed to an API method have incompatible values.
313MediaSharing
DisabledError
This account is not approved to use media sharing.You attempted to share a video, but your account is not enabled to use media sharing.
314MediaDeliveryType
DisabledError
This account is not enabled to the specified media delivery type (ie: http)You specified HTTP for the media delivery type of a video, but your account is not enabled for it.
315MethodRestrictedAccess to the requested API method is restricted for the given token.You called an unfiltered read method with a token that is not enabled for unfiltered methods.
316GeographyRestrictedAccess to the requested account's data
is restricted for the current geography.
You used a token that
is associated with an IP address restricted account from an an IP address that is not allowed for that account.
317DistributionDisabledErrorThis account is not approved to use the distribution feature.You tried to use a token to use distribution feature, and the account isn't enabled for it.
403N/AForbidden, no credentialsYou tried to make a Media API call without using a token.

Viewing all articles
Browse latest Browse all 2356

Latest Images

Trending Articles



Latest Images