get
Obtain an Access-Token

https://zeroth.goodatlas.com:2053
/token
Obtain an access-token to use the WebSocket endpoint.
Request
Response
Headers
Authorization
required
string
appId:appSecret
200: OK
The access_token can be used to open a WebSocket connection within the expires_in time.
{"access_token":"abcd","token_type":"Bearer","expires_in":600}
400: Bad Request
403: Forbidden
When no Authorization header or invalid credentials were provided.

post
Send URL of an audio file

https://zeroth.goodatlas.com:2053
/transcripts
Send a JSON request that contains a URL of an audio file.
Request
Response
Headers
Authorization
required
string
appId:appSecret
Body Parameters
language
required
string
The language of the audio. eng or kor
audioUrl
required
string
URL of the audio file
200: OK
The id can be used to fetch the result.
// when transcription is done
{"id":1309,"status":"done","transcript":"HELLO WORLD FROM ZEROTH CLOUD."}
// when transcription is still in progress
{"id":1309,"status":"queued","transcript":""}
// when transcription failed with error
{"id":1309,"status":"error","transcript":""}
400: Bad Request
403: Forbidden
When no Authorization header or invalid credentials were provided.

get
Get the result of a transcription

https://zeroth.goodatlas.com:2053
/transcripts/{id}
Get the result of a transcription. The id will be response of the corresponding POST request
Request
Response
Path Parameters
id
required
number
The id of the transcript
Headers
Authorization
required
string
appId:appSecret
200: OK
// when transcription is done
{"id":1309,"status":"done","transcript":"HELLO WORLD FROM ZEROTH CLOUD."}
// when transcription is still in progress
{"id":1309,"status":"queued","transcript":""}
// when transcription failed with error
{"id":1309,"status":"error","transcript":""}
400: Bad Request
If no transcript with the given Id exist.
403: Forbidden
When no Authorization header or invalid credentials were provided.