{"id":14331,"date":"2022-08-09T14:19:47","date_gmt":"2022-08-09T17:19:47","guid":{"rendered":"https:\/\/jmvstream.com\/video-upload\/"},"modified":"2022-08-09T15:45:14","modified_gmt":"2022-08-09T18:45:14","slug":"video-upload","status":"publish","type":"post","link":"https:\/\/jmvstream.com\/en\/development\/video-upload\/","title":{"rendered":"Video upload"},"content":{"rendered":"

[vc_row][vc_column][vc_column_text]The upload of videos is initiated through a POST request in the route <code>\/v1\/videos<\/code> This route will only be used to create the upload, and not for the upload itself. From the call of this route, data will be returned in the HEADERS of the response that will be used to perform the upload.<\/p>\n

 <\/p>\n

The upload itself will be done via the \/v1\/videos\/uploads\/:id route<\/p>\n

 <\/p>\n

Currently the API does not accept more than one upload at a time.[\/vc_column_text][\/vc_column][\/vc_row][vc_row apply_row_margin=”top_bottom” row_margin_top_bottom=”30px”][vc_column][vc_column_text]<\/p>\n

Creating the Upload – POST<\/h1>\n

[\/vc_column_text][\/vc_column][\/vc_row][vc_row apply_row_margin=”top_bottom” row_margin_top_bottom=”15px”][vc_column][vc_column_text]<\/p>\n

Route<\/h2>\n

[\/vc_column_text][inova_raw_html]<\/p>\n\n\n\n\n\n
Method<\/th>\nRoute<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
POST<\/td>\n\/v1\/videos<\/code><\/td>\nRoute for creating the upload.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

[\/inova_raw_html][vc_column_text]* Token generated by the authentication route<\/a>[\/vc_column_text][\/vc_column][\/vc_row][vc_row apply_row_margin=”top_bottom” row_margin_top_bottom=”15px”][vc_column][vc_column_text]<\/p>\n

Headers<\/h2>\n

[\/vc_column_text][inova_raw_html]<\/p>\n\n\n\n\n\n\n\n\n\n\n
Param<\/th>\nType<\/th>\nDescription<\/th>\nRequired<\/th>\n<\/tr>\n<\/thead>\n
Tus-Resumable<\/td>\nString<\/code><\/td>\nTUS protocol version. Always send 1.0.0<\/td>\nYes<\/td>\n<\/tr>\n
Upload-Length<\/td>\nNumber<\/code><\/td>\nSize of the file to be uploaded (In bytes).<\/td>\nYes<\/td>\n<\/tr>\n
Upload-Metadata<\/td>\nString<\/code><\/td>\n“filename” followed by the base64 filename.
\nEx.: File name: test_converted=> Upload-Metadata: filename dGVzdGUubXA0.<\/td>\n		Yes<\/td>\n<\/tr>\n
Content-Type<\/td>\nString<\/code><\/td>\napplication\/json<\/td>\nNo<\/td>\n<\/tr>\n
gallery<\/td>\nString<\/code><\/td>\nUuid of the gallery that will be uploaded later.<\/td>\nNo<\/td>\n<\/tr>\n
Authorization<\/td>\nString<\/code><\/td>\nToken authorization.<\/td>\nYes<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

[\/inova_raw_html][\/vc_column][\/vc_row][vc_row apply_row_margin=”individually” row_margin_bottom=”10px”][vc_column][vc_row_inner][vc_column_inner][vc_column_text]<\/p>\n

Response<\/h2>\n

[\/vc_column_text][\/vc_column_inner][\/vc_row_inner][vc_row_inner][vc_column_inner][vc_column_text]- Response when performing an upload (Status: 201)[\/vc_column_text][inova_raw_html]<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n
Name<\/th>\nValue<\/th>\n<\/tr>\n<\/thead>\n
X-Powered-By<\/td>\nExpress<\/td>\n<\/tr>\n
Tus-Resumable<\/td>\n1.0.0<\/td>\n<\/tr>\n
Access-Control-Expose-Headers<\/td>\nAuthorization, Content-Type, Location, Tus-Extension, Tus-Max-Size, Tus-Resumable, Tus-Version, Upload-Defer-Length, Upload-Length, Upload-Metadata, Upload-Offset, X-HTTP-Method-Override, X-Requested-With<\/td>\n<\/tr>\n
Location<\/td>\n\/\/localhost:15214\/v1\/videos\/uploads\/410b471ac3ed2ee0f8856e7aa4358ba4<\/td>\n<\/tr>\n
Content-Length<\/td>\n0<\/td>\n<\/tr>\n
Date<\/td>\nTue, 21 Jun 2022 13:09:10 GMT<\/td>\n<\/tr>\n
Connection<\/td>\nkeep-alive<\/td>\n<\/tr>\n
Keep-Alive<\/td>\ntimeout=5<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

[\/inova_raw_html][\/vc_column_inner][\/vc_row_inner][vc_row_inner][vc_column_inner][vc_column_text]- Error response when not sending required field or field in incorrect format (Status: 400)[\/vc_column_text][vc_column_text]<\/p>\n

{\r\n   \"error\": \"Bad Request\"\r\n}<\/pre>\n
[\/vc_column_text][\/vc_column_inner][\/vc_row_inner][vc_row_inner][vc_column_inner][vc_column_text]- Error response when trying to perform more uploads at a time per application (Status: 429)[\/vc_column_text][vc_column_text]<\/p>\n
{\r\n   \"error\": \"Too many simultaneous uploads, please send one file at a time\"\r\n}<\/pre>\n
[\/vc_column_text][\/vc_column_inner][\/vc_row_inner][vc_row_inner][vc_column_inner][vc_column_text]- Error response for some internal error (Status: 500)[\/vc_column_text][vc_column_text]<\/p>\n
{\r\n  \"error\": \"Internal Server Error\"\r\n}<\/pre>\n
[\/vc_column_text][\/vc_column_inner][\/vc_row_inner][\/vc_column][\/vc_row][vc_row apply_row_margin=”top_bottom” row_margin_top_bottom=”30px”][vc_column][vc_column_text]<\/p>\n
Upload – PATCH<\/h1>\n
[\/vc_column_text][\/vc_column][\/vc_row][vc_row apply_row_margin=”top_bottom” row_margin_top_bottom=”15px”][vc_column][vc_column_text]<\/p>\n
Route<\/h2>\n
[\/vc_column_text][inova_raw_html]<\/p>\n\n\n\n\n\n
Method<\/th>\nRoute<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
PATCH<\/td>\n\/v1\/videos\/uploads\/:id<\/code><\/td>\nRoute to upload.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
[\/inova_raw_html][vc_column_text]NOTE:<\/strong> In this request, the video specified in Upload-Metadata must be passed in its binary form. As an example, in Insomnia, it would be selecting the ‘file’ option, and then selecting the ‘Binary file’ option, and then selecting the desired file.[\/vc_column_text][\/vc_column][\/vc_row][vc_row apply_row_margin=”top_bottom” row_margin_top_bottom=”15px”][vc_column][vc_column_text]<\/p>\n
Headers<\/h2>\n
[\/vc_column_text][inova_raw_html]<\/p>\n\n\n\n\n\n\n\n\n\n\n\n
Param<\/th>\nType<\/th>\nDescription<\/th>\nRequired<\/th>\n<\/tr>\n<\/thead>\n
Tus-Resumable<\/td>\nString<\/code><\/td>\nTUS protocol version. Always send 1.0.0<\/td>\nYes<\/td>\n<\/tr>\n
Content-Length<\/td>\nNumber<\/code><\/td>\nAmount in bytes remaining to be uploaded.<\/td>\nYes<\/td>\n<\/tr>\n
Upload-Offset<\/td>\nNumber<\/code><\/td>\nInitial byte for the upload (If it is the first request, it must start with 0, if the upload has been interrupted, the upload must continue where it left off, this information is provided by the Upload-Offset parameter returned in the HEAD \/ v1\/videos\/uploads\/:id).<\/td>\nYes<\/td>\n<\/tr>\n
Upload-Metadata<\/td>\nString<\/code><\/td>\n“filename” followed by the base64 filename. Ex.: File name: test_converted=> Upload-Metadata: filename dGVzdGUubXA0.<\/td>\nYes<\/td>\n<\/tr>\n
Content-Type<\/td>\nString<\/code><\/td>\napplication\/offset+octet-stream<\/td>\nYes<\/td>\n<\/tr>\n
gallery<\/td>\nString<\/code><\/td>\nUuid of the gallery that will be uploaded later.<\/td>\nNo<\/td>\n<\/tr>\n
Authorization<\/td>\nString<\/code><\/td>\nToken authorization.<\/td>\nYes<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
[\/inova_raw_html][\/vc_column][\/vc_row][vc_row apply_row_margin=”individually” row_margin_bottom=”10px”][vc_column][vc_row_inner][vc_column_inner][vc_column_text]<\/p>\n
Response<\/h2>\n
[\/vc_column_text][\/vc_column_inner][\/vc_row_inner][vc_row_inner][vc_column_inner][vc_column_text]<\/p>\n
– Response header when uploading (Status: 201)<\/h4>\n
[\/vc_column_text][inova_raw_html]<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n
Name<\/th>\nValue<\/th>\n<\/tr>\n<\/thead>\n
X-Powered-By<\/td>\nExpress<\/td>\n<\/tr>\n
Tus-Resumable<\/td>\n1.0.0<\/td>\n<\/tr>\n
Access-Control-Expose-Headers<\/td>\nAuthorization, Content-Type, Location, Tus-Extension, Tus-Max-Size, Tus-Resumable, Tus-Version, Upload-Defer-Length, Upload-Length, Upload-Metadata, Upload-Offset, X-HTTP-Method-Override, X-Requested-With<\/td>\n<\/tr>\n
Location<\/td>\n\/\/localhost:15214\/v1\/videos\/uploads\/410b471ac3ed2ee0f8856e7aa4358ba4<\/td>\n<\/tr>\n
Content-Length<\/td>\n0<\/td>\n<\/tr>\n
Date<\/td>\nTue, 21 Jun 2022 13:09:10 GMT<\/td>\n<\/tr>\n
Connection<\/td>\nkeep-alive<\/td>\n<\/tr>\n
Keep-Alive<\/td>\ntimeout=5<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
[\/inova_raw_html][\/vc_column_inner][\/vc_row_inner][vc_row_inner][vc_column_inner][vc_column_text]<\/p>\n
– Error response when not uploading-metadata correctly (Status: 400)<\/h4>\n
[\/vc_column_text][vc_column_text]<\/p>\n
{\r\n    \"error\": \"Bad Request\"\r\n}<\/pre>\n
[\/vc_column_text][\/vc_column_inner][\/vc_row_inner][vc_row_inner][vc_column_inner][vc_column_text]<\/p>\n
– Error response when trying to perform more uploads at a time per application (Status: 429)<\/h4>\n
[\/vc_column_text][vc_column_text]<\/p>\n
{\r\n    \"error\": \"Too many simultaneous uploads, please send one file at a time\"\r\n}<\/pre>\n
[\/vc_column_text][\/vc_column_inner][\/vc_row_inner][vc_row_inner][vc_column_inner][vc_column_text]<\/p>\n
– Error response for some internal error (Status: 500)<\/h4>\n
[\/vc_column_text][vc_column_text]<\/p>\n
{\r\n  \"error\": \"Internal Server Error\"\r\n}<\/pre>\n
[\/vc_column_text][\/vc_column_inner][\/vc_row_inner][\/vc_column][\/vc_row][vc_row apply_row_margin=”top_bottom” row_margin_top_bottom=”30px”][vc_column][vc_column_text]<\/p>\n
Returns information from the Upload – HEAD<\/h1>\n
[\/vc_column_text][\/vc_column][\/vc_row][vc_row apply_row_margin=”top_bottom” row_margin_top_bottom=”15px”][vc_column][vc_column_text]<\/p>\n
Route<\/h2>\n
[\/vc_column_text][inova_raw_html]<\/p>\n\n\n\n\n\n
Method<\/th>\nRoute<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
PATCH<\/td>\n\/v1\/videos\/uploads\/:id<\/code><\/td>\nRoute to upload.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
[\/inova_raw_html][\/vc_column][\/vc_row][vc_row apply_row_margin=”top_bottom” row_margin_top_bottom=”15px”][vc_column][vc_column_text]<\/p>\n
Headers<\/h2>\n
[\/vc_column_text][inova_raw_html]<\/p>\n\n\n\n\n\n\n
Param<\/th>\nType<\/th>\nDescription<\/th>\nRequired<\/th>\n<\/tr>\n<\/thead>\n
Authorization<\/td>\nString<\/code><\/td>\nToken authorization.<\/td>\nYes<\/td>\n<\/tr>\n
Tus-Resumable<\/td>\nString<\/code><\/td>\nTUS protocol version. Always send 1.0.0<\/td>\nYes<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
[\/inova_raw_html][\/vc_column][\/vc_row][vc_row apply_row_margin=”individually” row_margin_bottom=”10px”][vc_column][vc_row_inner][vc_column_inner][vc_column_text]<\/p>\n
Response<\/h2>\n
[\/vc_column_text][\/vc_column_inner][\/vc_row_inner][vc_row_inner][vc_column_inner][vc_column_text]NOTE:<\/strong> The Upload_Offset parameter returned indicates how many bytes have already been sent, when the Upload-Offset is equal to the Upload-length, the upload is completed.[\/vc_column_text][\/vc_column_inner][\/vc_row_inner][vc_row_inner][vc_column_inner][vc_column_text]- Response header when uploading (Status: 201)[\/vc_column_text][inova_raw_html]<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n
Name<\/th>\nValue<\/th>\n<\/tr>\n<\/thead>\n
X-Powered-By<\/td>\nExpress<\/td>\n<\/tr>\n
Tus-Resumable<\/td>\n1.0.0<\/td>\n<\/tr>\n
Access-Control-Expose-Headers<\/td>\nAuthorization, Content-Type, Location, Tus-Extension, Tus-Max-Size, Tus-Resumable, Tus-Version, Upload-Defer-Length, Upload-Length, Upload-Metadata, Upload-Offset, X-HTTP-Method-Override, X-Requested-With<\/td>\n<\/tr>\n
Location<\/td>\n\/\/localhost:15214\/v1\/videos\/uploads\/410b471ac3ed2ee0f8856e7aa4358ba4<\/td>\n<\/tr>\n
Content-Length<\/td>\n0<\/td>\n<\/tr>\n
Date<\/td>\nTue, 21 Jun 2022 13:09:10 GMT<\/td>\n<\/tr>\n
Connection<\/td>\nkeep-alive<\/td>\n<\/tr>\n
Keep-Alive<\/td>\ntimeout=5<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
[\/inova_raw_html][\/vc_column_inner][\/vc_row_inner][vc_row_inner][vc_column_inner][vc_column_text]- Error response for some internal error (Status: 500)[\/vc_column_text][vc_column_text]<\/p>\n
{\r\n  \"error\": \"Internal Server Error\"\r\n}<\/pre>\n
[\/vc_column_text][\/vc_column_inner][\/vc_row_inner][\/vc_column][\/vc_row]<\/p>\n<\/div>","protected":false},"excerpt":{"rendered":"
[vc_row][vc_column][vc_column_text]The upload of videos is initiated through a POST request in the route <code>\/v1\/videos<\/code> This<\/p>\n","protected":false},"author":39,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"documentation.php","format":"standard","meta":{"footnotes":""},"categories":[410,412],"tags":[],"class_list":["post-14331","post","type-post","status-publish","format-standard","hentry","category-development","category-videos"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/jmvstream.com\/en\/wp-json\/wp\/v2\/posts\/14331","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/jmvstream.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/jmvstream.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/jmvstream.com\/en\/wp-json\/wp\/v2\/users\/39"}],"replies":[{"embeddable":true,"href":"https:\/\/jmvstream.com\/en\/wp-json\/wp\/v2\/comments?post=14331"}],"version-history":[{"count":0,"href":"https:\/\/jmvstream.com\/en\/wp-json\/wp\/v2\/posts\/14331\/revisions"}],"wp:attachment":[{"href":"https:\/\/jmvstream.com\/en\/wp-json\/wp\/v2\/media?parent=14331"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/jmvstream.com\/en\/wp-json\/wp\/v2\/categories?post=14331"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/jmvstream.com\/en\/wp-json\/wp\/v2\/tags?post=14331"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}