File resource

Add large file version

OVERVIEW


Method to create a new version of a large file. Please refer to Add large file API method to understand the purpose of provide a large file upload method in addition to a file upload API method. 

Step 1 :

Purpose



API method to obtain a progress key. 

Request URL

GET /sites/{siteid}/documentprogresskey/



Sample request URL : https://domain.com/instancename/api/1/sites/2/documentprogresskey

Response

rsxSEFlmFB_1423555822871

 

Step 2 :

Purpose



Call to add a version to an existing file

 

Resource(API) EndPoint      Query Params       Form Params HTTP Method Request

XML
Response

XML
Response

Code
/files/{fileid}/content

 

 sourceclient={sourceclient} (optional)

progressiveoperkey={documentprogresskey} (optional)

filename={a string value} 

this is form type parameter.

(mandatory parameter)



notification={a string value} this is optional form type parameter

POST   Response XML Response Code

Sample request URL : https://domain.com/instancename/api/1/files/122/content?progressiveoperkey=rsxSEFlmFB_1423555822871



Assumptions :



The API method supports an optional form data parameter called "notification"  which is used for "notification" preference.



1 = Respect user preference

2 = Force email notification

3 = Suppress all notifications



The default value of notification parameter is 3 

Response XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<file>

    <fileid>122</fileid>

    <status>INPROGRESS</status>

    <documentKey>rsxSEFlmFB_1423555822871</documentKey>

</file>
 

Response Code

Code Meaning
201 Document's version uploaded  successfully
401 Unauthorized
403 Validation failed/ Forbidden
405 Method not allowed (calling api with wrong method)
500 Internal error occurred while uploading document

 

Step 3 :

Purpose

   Once the file upload has been started using step 2, the following method is to be called to determine the status of the document being uploaded. 

 

Resource(API) EndPoint      Query Params       Form Params HTTP Method Request

XML
Response

XML
Response

Code
/sites/{siteid}/documentstatus/{documentkey} 

 

 

POST   Response XML  

Sample request URL : https://domain.com/instancename/api/1/sites/2/documentstatus/rsxSEFlmFB_1423555822871

 

Response XML

<ProgressiveDocResponse>

    <documentID>122</documentID>

    <status>INPROGRESS</status>

    <documentKey>rsxSEFlmFB_1423555822871</documentKey>

</ProgressiveDocResponse>



Once the upload has completed the following response will confirm the upload. 



<ProgressiveDocResponse>

    <documentID>122</documentID>

    <status>Done</status>   

</ProgressiveDocResponse>

Comments


0 Comments

Last Updated: Jun 09,2023