|
|
|
The Direct File Upload API is for application users to directly upload files into Dovetail Seeker. This API is proxied and is publicly available. Uploaded files can later be retrieved from the file download API using the file's Key.
Applications will typically setup the web browser to POST to this API using the results returned from the file upload token API. After the file is uploaded it is the responsibility of the application to remember the file upload components (key, file name, content type) for future retrieval of the uploaded file.
For more details take a look at the File Upload Process sequence diagram.
Input
URL:
/seeker/file/upload
HTTP Method(s):
POST
Parameters
Parameter |
Required |
Default |
Description |
UploadToken |
Yes |
N/A |
The upload token returned by the file upload token API. When the token is invalid a 404 status will be returned. When the token has expired a 403 status will be returned. |
Files |
Yes |
N/A |
The form used to POST the file should have a file input with a name of "Files". Only one file can be uploaded at a time. If no files or more than one file were uploaded a 400 status will be returned. |
Timeout |
No |
5 minutes |
How long should the upload token be valid. |
Response:
Parameter |
Description |
DownloadURL |
URL from which this file can be downloaded. |
Key |
Key identifying the file uploaded. This value is used to generate a download URL. |
Examples
Request:
POST /seeker/file/upload
Response:
{
DownloadURL: "http://localhost/seekerproxy/file/download/random-download-token-id"
Key: "2014/01/case/1234/2014/01/Case/1234/random-ksdfj213kdj87"
}
See Also |
Next |