Uploading File
From DreamFactory
(Created page with "### Tutorial DreamFactory 2.0 allows you to expose various storage services as API Endpoints. The following storage services are currently supported. * Local Storage (conf...") |
|||
| Line 1: | Line 1: | ||
| − | + | === Tutorial === | |
DreamFactory 2.0 allows you to expose various storage services as API Endpoints. The following storage services are currently | DreamFactory 2.0 allows you to expose various storage services as API Endpoints. The following storage services are currently | ||
| Line 10: | Line 10: | ||
* Rackspace Cloud Files | * Rackspace Cloud Files | ||
| − | + | === Provisioning a Storage Service === | |
All DreamFactory 2.0 instances come pre-configured with a 'Local Storage' service named 'files'. You can find this service | All DreamFactory 2.0 instances come pre-configured with a 'Local Storage' service named 'files'. You can find this service | ||
| Line 21: | Line 21: | ||
storage service - 'files'. | storage service - 'files'. | ||
| − | + | === API Endpoints === | |
| − | + | ==== Uploading a binary file ==== | |
Uploading a file using URL | Uploading a file using URL | ||
| Line 42: | Line 42: | ||
</pre> | </pre> | ||
| − | + | ==== Uploading a zip file and extracting its content ==== | |
Uploading a zip file using URL | Uploading a zip file using URL | ||
| Line 61: | Line 61: | ||
</pre> | </pre> | ||
| − | + | ==== Delete existing folder content before uploading a zip file and extracting its content ==== | |
Uploading a zip file using URL | Uploading a zip file using URL | ||
| Line 81: | Line 81: | ||
| − | + | === Example - Upload a JPEG image to a directory called images using storage service called 'files' === | |
* Storage service: files | * Storage service: files | ||
| Line 89: | Line 89: | ||
<pre>POST http://foo.com/api/v2/files/images/?url=http://example.com/images/profile_picture.jpg</pre> | <pre>POST http://foo.com/api/v2/files/images/?url=http://example.com/images/profile_picture.jpg</pre> | ||
| − | + | === Example - Upload a zip file to a directory called documents using storage service called 'files' and extract it. === | |
* Storage service: files | * Storage service: files | ||
| Line 97: | Line 97: | ||
<pre>POST http://foo.com/api/v2/files/images/?url=http://example.com/docs.zip&extract=true</pre> | <pre>POST http://foo.com/api/v2/files/images/?url=http://example.com/docs.zip&extract=true</pre> | ||
| − | + | === Example - Delete existing directory content before uploading a zip file and extracting it. === | |
* Storage service: files | * Storage service: files | ||
Revision as of 17:57, 3 February 2016
Contents
- 1 Tutorial
- 2 Provisioning a Storage Service
- 3 API Endpoints
- 4 Example - Upload a JPEG image to a directory called images using storage service called 'files'
- 5 Example - Upload a zip file to a directory called documents using storage service called 'files' and extract it.
- 6 Example - Delete existing directory content before uploading a zip file and extracting it.
Tutorial
DreamFactory 2.0 allows you to expose various storage services as API Endpoints. The following storage services are currently supported.
- Local Storage (configurable to use local file system, S3, Azure, or Rackspace)
- AWS S3
- Azure Blob
- OpenStack Object Storage
- Rackspace Cloud Files
Provisioning a Storage Service
All DreamFactory 2.0 instances come pre-configured with a 'Local Storage' service named 'files'. You can find this service on the admin console, under the services tab. You can also provision as many other storage services as you like using the admin console. Login to the admin console and select the 'Services' tab. Click on the 'Create' button from the left menu. On the service creation form select your storage type from the 'Service Type' drop down box (File section). Enter a short, one-word, meaningful name for your service as well as a label and description. Depending on which storage type you pick, you will need to enter the service configuration values on the 'Config' tab. Create your storage service after entering all your configuration values. Your storage service is now ready for action. For this tutorial, we will use the pre-configured storage service - 'files'.
API Endpoints
Uploading a binary file
Uploading a file using URL
POST http://{url}/api/v2/{storage_service_name}?url={remote_url}
Uploading a file using form post
POST http://{url}/api/v2/{storage_service_name}
Request header:
...
Content-Type: multipart/form-data;
...
Request payload:
-- <file content> --
Uploading a zip file and extracting its content
Uploading a zip file using URL
POST http://{url}/api/v2/{storage_service_name}?url={remote_url}&extract=true
Uploading a zip file using form post
POST http://{url}/api/v2/{storage_service_name}?extract=true
Request header:
...
Content-Type: multipart/form-data;
...
Request payload:
-- <file content> --
Delete existing folder content before uploading a zip file and extracting its content
Uploading a zip file using URL
POST http://{url}/api/v2/{storage_service_name}?url={remote_url}&extract=true&clean=true
Uploading a zip file using form post
POST http://{url}/api/v2/{storage_service_name}?extract=true&clean=true
Request header:
...
Content-Type: multipart/form-data;
...
Request payload:
-- <file content> --
Example - Upload a JPEG image to a directory called images using storage service called 'files'
- Storage service: files
- Destination directory: images/
- JPEG image URL: http://example.com/images/profile_picture.jpg
- Request URL:
POST http://foo.com/api/v2/files/images/?url=http://example.com/images/profile_picture.jpg
Example - Upload a zip file to a directory called documents using storage service called 'files' and extract it.
- Storage service: files
- Destination directory: documents/
- Zip file URL: http://example.com/docs.zip
- Request URL:
POST http://foo.com/api/v2/files/images/?url=http://example.com/docs.zip&extract=true
Example - Delete existing directory content before uploading a zip file and extracting it.
- Storage service: files
- Destination directory: documents/
- Zip file URL: http://example.com/docs.zip
- Request URL:
POST http://foo.com/api/v2/files/images/?url=http://example.com/docs.zip&extract=true&clean=true
