Examples of calling the /request API
The following examples show calling the /request method with some of its verbs, using the cURL command-line utility (executed as the curl command). Sample output is also provided, but depends on the host on which the API is running, the contents of the zip or audio file that you uploaded, the request ID, the organization to which you uploaded the file, and authorization token that you are using. The cURL utility is freely available for multiple operating systems including Linux, Windows, and macOS.
Note
Escaped newlines (that is, lines in the cURL command or the example output that end with a backslash) are added for readability. They must not be present in cURL commands, and are also not present in the output of those commands.
Example commands are shown in normal monospaced text. Example output from each command is shown in bold, monospaced text.
A cURL example that shows calling the /request API's status verb:
curl 'http://example.company.com/request/Test-Testing/status \
?requestid=a0cf623d-9e5c-4890-886f-832acb29635e \
&token=0123456789abcde0123456789abcde01'
doneA cURL example that shows calling the /request API's summary verb:
curl 'http://example.company.com/request/Test-Testing/summary\
?requestid=a0cf623d-9e5c-4890-886f-832acb29635e\
&token=0123456789abcde0123456789abcde01'
{"time_submit":"2017-01-16T21:43:08.000Z",\
"time_complete":"2017-01-16T21:45:16.000Z",\
"submitted":1,"processed":1,"analyzed":1,"error":0,"status":"done"}A cURL example that shows calling the /request API's details verb:
curl 'http://example.current.com/request/Test-Testing/details?\
requestid=a0cf623d-9e5c-4890-886f-832acb29635e\
&token=0123456789abcde0123456789abcde01'
{"time_submit":"2017-01-16T21:43:08.000Z",\
"time_complete":"2017-01-16T21:45:16.000Z", \
"submitted":1,"processed":1,"analyzed":1,"error":0,"status":"done",\
"filedetails":[{"fullfilename":"Call4541511.mp3","status":"OK",\
"job_start":"2017-01-16T21:45:14.000Z",\
"job_finish":"2017-01-16T21:43:12.000Z",\
"analyze":"2017-01-16T21:45:14.000Z","size":4984848}]}A cURL example that shows calling the /request API's result verb to return the JSON transcript of your audio file and write it to the file json_transcript.zip:
curl 'http://example.company.com/request/Test-Testing/result?\
requestid=a0cf623d-9e5c-4890-886f-832acb29635e\
&token=0123456789abcde0123456789abcde01' > json_transcript.zip
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 28304 100 28304 0 0 2780 0 0:00:10 0:00:10 --:--:-- 6821
(Displays cURL's download status)