If use files/append_v2 with close=true need finish?

bfmsoft

There is a new API files/append_v2 with the close=true.  Do I need to call Finish if I specify close=true on the last append_v2 call?  That would save me one API call to the server.

 

Also, what does the close really do?  I can't find any documentation on what it means.

Greg-DB

The documentation for /2/files/upload_session/append_v2 describes the close parameter as:

 

"close Boolean If true, the current session will be closed, at which point you won't be able to call upload_session/append_v2 anymore with the current session. The default for this field is False."

 

That is, you can't add more data to an upload session once you "close" it. You should close it once you've finished uploading the data for that file.

 

You do still need to call finish, even if you've already closed the upload session. When you call finish, you commit the upload, specifying the desired file path, write mode, etc.