JSON API » queues » queues/files/download

Downloads the message file of a queue.

Input parameters

Requires authentication and the user role privilege.

NameTypeDescriptionRequiredDefault value
auth_usernameStringAuthentication username.Yes
auth_passwordStringAuthentication password.Yes
queueIntegerID of queue.Yes
checkInteger1 to just check if the file exists, 0 to download it.No0
encodingString"base64" to return file base64 encoded, "raw" to return raw data.No"raw"

Responses

CodeDescription
200Success.
401The authentication details provided are invalid.
402Your role does not allow this.
404The queue or file does not exist, or you do not have permission to view it.

If check=1 was specified and the file does not exist, 200 is returned.

Data returned

If checking, whether the file was found or not. If not checking, the sound file data plus name and mime-type.

Example: Download file (data truncated for brevity)

http://enswitch.example.com/api/json/queues/files/download/?auth_username=user;auth_password=password;queue=123

{ "responses":[ { "code":"200", "key":"", "message":"OK" } ], "data":{ "id":123, "name":"example.wav", "mimetype":"audio/x-wav", "data":"RIFFn..." } }

Example: Check if file exists, and it does

http://enswitch.example.com/api/json/queues/files/download/?auth_username=user;auth_password=password;queue=123;check=1

{ "responses":[ { "code":"200", "key":"", "message":"OK" } ], "data":{ "found":1 } }

Example: Check if file exists, and it doesn't

http://enswitch.example.com/api/json/queues/files/download/?auth_username=user;auth_password=password;queue=123;check=1

{ "responses":[ { "code":"200", "key":"", "message":"OK" } ], "data":{ "found":0 } }

Change history

VersionChanges
3.13Function added.