The Media File API

provides access to media files submitted by users for a specified Form Entry.  The specific file name must be retrieved from a Form Entry API call as outlined above.

On the Cloud this API is available using the REST GET verb:

http://secure.formsfly.com/api/v1/mediafile

GET Parameters

The required parameters for a GET call to the Media Files API are outlined below.

Parameter Name Data Type Required Description
ProviderId Integer Yes Your unique Provider Id found on the Organisation Setup page of the secure website (under Your Account)
Integrationkey String Yes Your unique Integration Key found on the Organisation Setup page of the secure website (under Your Account)
EntryId String Yes The Id of the Form Entry that this media file belongs to.  This value is found on each Form Entry that you retrieve via the Form Entries API.
FileName String Yes The name of the file to retrieve.  This value is found in the relevant Form Entry answer from the Form Entries API.

GET Response

If the file is found, then the response will be the file contents with MIME type appropriate HTTP headers.

If the file is not found then the response is empty.

API Usage Example

Given that the API is REST based, you can access the API directly via your web browser to test it.  Obviously for actual integration works, you will need to make a web request to the given REST URL and then parse the response.

GET Request

http://secure.formsfly.com/api/v1/mediafile?EntryId=c67d58d4-5e7a-4248-9d19-fd07a50016ff&FileName=162626273723.jpg&integrationkey=xxxxxxxxxxxx&providerid=1
API – DELETE User. API – DELETE Task. REST Connector. API – Form GET Entries. API – POST Form Entry to External Web Service. API FormsFly System. API – GET Data Source. Advanced Integration. API – POST User. API – POST Task. Integration API Overview. API – PUT User. API – PUT Data Source. API – GET Tasks. Will it connect to our existing systems?. API – Form GET Media File. API – GET Users.