Using Postman to test Speech & Conversation Analytics APIs
The Speech Analytics API Bundle provides a REST API interface to accurately transcribe your meetings, phone calls, and other offline meeting recordings and extract speech and conversation insights using Marsview's proprietary AI and NLP models.
For easy testing using Postman, we provided a Postman Collection for Marsview Speech Analytics APIs. This is a simple 6 step tutorial to quickly test out the Marsview Speech & Conversation Analytics APIs.
The files are available here:
After downloading Postman and Marsview's Postman Collection. You can
File > importthe collection into Postman to get started.
Get your API Key and API Secret by registering to Marsview as a developer.
"apiKey": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" "apiSecret": "xxxxxxx-xxxxxxx-xxxxxxx-xxxxxxx"
Set a New Environment on Postman as shown below, this will ensure all the variables that will be set in further steps in the process are correctly assigned.
Click on the
More > Edit
apiSecretas Workspace variables on Postman as shown below.
Using the API
[POST] Get tokenAPI you will be able to generate an
accessTokenthat will expire in 1 hour from the time of token generation. You will be able to upload an audio/video file or a file URL using this
Instruction: Click on
Get tokenand click on
You can upload an Audio/Video File using
[POST] Upload fileor use
[POST] Upload file url(Recommended) to submit/upload a file URL.
Instruction: Fill in the file details such as
link(URL) and click on
This will generate a Transaction ID or
txnIdwhich is a unique ID generated for a particular file or URL submitted to Marsview.
Each AI model/API (mentioned in the Overview section) can be configured to get the most accurate results for your use case. To know more about the configurations go to Speech & Conversation API Overview.
Instruction: For ease of testing, we have preconfigured all the API to default configuration values so all you have to do is go to
[POST] Upload requestand hit
You will see an output JSON as shown below with the status
[GET] Request Statusis used to get the status of the file being processed. The status will go from
"completed". If there's an error transcribing your file, the status will go to
"error"and there will be an
"msg"key in the response JSON which will contain more information.
Once the Request Status is set to
"completed", you'll see a full JSON response with your transcription text, like this by sending a request to the
Instruction: Click on
[GET]Metadataand click on