Follow

GET Media File

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 via SSL secured HTTPS connection using the REST GET verb: https://secure.formsonfire.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 Organization Setup page of the secure website (under My Account)

Integrationkey

String

Yes

Your unique Integration Key found on the Organization Setup page of the secure website (under My 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

https://secure.formsonfire.com/api/v1/mediafile?
EntryId=c67d58d4-5e7a-4248-9d19-fd07a50016ff&FileName=162626273723.jpg&
integrationkey=xxxxxxxxxxxx&providerid=1
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk