Send a video to a list of friends. The method expects a userToken or a j_username/j_password pair from which the user of this request will be determined. If the j_username/j_password pair is provided for one-time authentication, the request has to be made using HTTPS protocol. If neither the userToken nor the j_username/j_password is provided, the owner of the application will be considered making this request. The userToken or the j_username/j_password pair, if present, have to be put into the request url. The enctype of the request has to be 'multipart/form-data'.This method is not available to general public. Only Veoh's partners can access this feature.
Request URL
HTTP(HTTPS)://www.veoh.com/rest/v1/?method=veoh.video.sendToFriends&apiKey=[your api key]
HTTP method
POST
Arguments
videoId(Required)
The Id for the video to retrieve, it has to be valid id existed in the system
message(Required)
The message body
usernames(Required)
The list of user names separated by comma. Each user name should only contain alphanumeric characters (0-9)(A-Z) between 3 and 40 characters long.
userToken(Optional)
The userToken that represents the requester
j_username(Optional)
The username of the user making this request. It has to represent a valid user in the sysetm.Combined with the j_password, it will be used to provide one time authentication.
j_password(Optional)
The password of the user making this request. Combined with the j_username, it will be used to provide one time authentication.
Example Response
#EXAMPLERESPONSE#
Error Codes
100 : rest.api.serviceUnavailable
The REST API service in temporarily unavailable
118 : rest.api.invalidApiKey
The api key provided in the url is not valid.
117 : rest.api.noApiKeyProvided
No api key has been provided in the request.
131 : rest.api.tooManyRequests
The number of requests made has exceeded the limit of this apiKey.
117 : rest.api.noApiKeyProvided
No api key has been provided in the request.
132 : rest.api.gapNotEnough
The request has to be made after a certain period of time associated with this apiKey
300 : rest.media.noIdProvided
No Id has been provided in the request
302 : rest.media.idNegative
The Id provided in the request is negative
301 : rest.media.idNotInteger
The Id provided in the request is not a valid integer
322 : rest.media.noMessageProvided
No message has been provided in the request.
325 : rest.media.invalidMessage
The message provided in the request is not valid.
204 : rest.user.noUserNameListProvided
No user name list has been provided in the request
205 : rest.user.invalidUsernameList
The user name list provided in the request is not valid. User names have to be separated by comma and each user name should only contain alphanumeric characters (0-9)(A-Z) between 3 and 40 characters long.
132 : rest.api.mustBeLoggedIn
This operation is only valid when a user is logged in
200 : rest.user.uesrNotFound
User is not found
400 : rest.video.videoNotFound
Video is not found
249 : rest.user.errorSendEmail
Error occurred while sending emails.
128 : rest.api.httpsReqired
HTTPS protocol is required for one time authentication.
247 : rest.user.invalidUserToken
The userToken provided in the request is not valid.
248 : rest.user.invalidUserTokenExpired
The userToken provided in the request has expired.
224 : rest.user.logginFailed
The username or the password provided in the request is not valid. Authentication failed.
