I have read the online documentation for the media/upload.json endpoint as well as the Guide to Uploading Media. While helpful overall, I believe that the documentation failed to answer the following questions.
- Is there a minimum size of the media file required for using the chunked upload method? In other words, is it safe to write our application to always use the chunked method, regardless of the media file upload size?
- If we are uploading Base64 encoded media, when making the
command=INIT, should the
total_bytesparameter be set to the total size of the Base64-encoded file, or the decoded file?
- The Guide to Uploading Media does a very poor job of explaining the difference between the synchronous and asynchronous methods for media file upload. Is there any difference in the way that the content is uploaded with the
FINALIZEcommands between these two methods? If so, please clarify.
- As a follow-up to the previous question, the discussion of the
STATUScommand describes that following an upload, the media may or may not be “processed” immediately after the
FINALIZEresponse is received. I think more needs to be said about this. What are the implications of the file not being not yet “processed”? Perhaps a link to other documentation would be appropriate here?