Turant SAAS

Introduction
Errors
Register Voice Sample
Verify Voice Sample
Merchant Details
Secret Key Generation

Introduction

Turant.ai Voice Verify AI solution has been developed to work on diverse languages and dialects such as those of India, with close to 20,000.

To get the hostname, you can see the section Merchant Details.

BASE URL

http://101.53.133.133/api/voice-registration

Errors

These are the HTTP response codes to indicate the success or failure of an API request. The code in 2xx range indicates success. The code in 4xx range indicates an error that failed. Codes in the 5xx range indicates an error from the server's end.

HTTP STATUS CODE SUMMARY

200

Successful API call.

400

Bad Request

The request was unacceptable, often due to missing a required parameter.

401

Unauthorized

Invalid access credentials.

404

Not Found

The request can't be found.

429

Too Many Requests

The request exceeded second(s) the limit of 25 in 5.

500

Internal Server Error

The request failed,could be due to many reasons.Check the exception message to get more details.

Register Voice Sample

In the headers, we use application/json value only for the parameters accept and content-type.

cURL

{{ App\Models\ApiRequestLog::CURL }}

Register Voice Object

Attributes

reg_url_1 string

First sample of the audio

reg_url_2 string

Second sample of the audio

merchant_id integer

Unique identifier of the merchant

merchant_name string

Name of the merchant

secret_key string

Unique secret key of the merchant

storage string

This parameter is for storage. It can have two values : Yif storage is allowed and Nif storage is not allowed

service_name string

Name of the service want to be used. It can have two values : fixed_digit or free_speech

Response

Returns an object with status, message and data i.e. sent by the api.

Returns an error otherwise.

Audio File Specification

Specification	Value
Sample Rate	8000
Audio File Type	WAV
Channel	Mono

OBJECT

{{ App\Models\ApiRequestLog::REGISTER_OBJECT }}

Response

{{ App\Models\ApiRequestLog::RESPONSE_SUCCESS }}

Verify Voice Sample

Verifies the voice sample by using the parameters listed can help you to get success.

In the headers, we use application/json value only for the parameters accept and content-type.

cURL

{{ App\Models\ApiRequestLog::CURL }}

Verify Voice Object

Attributes

reg_url_1 string

First sample of the audio

reg_url_2 string

Second sample of the audio

ver_url_1 string

Verification sample of the audio

merchant_id integer

Unique identifier of the merchant

merchant_name string

Name of the merchant

secret_key string

Unique secret key of the merchant

storage string

This parameter is for storage. It can have two values : Yif storage is allowed and Nif storage is not allowed

service_name string

Name of the service want to be used. It can have two values : fixed_digit or free_speech

Response

Returns an object with status, message and data i.e. sent by the api.

Returns an error otherwise.

Audio File Specification

Specification	Value
Sample Rate	8000
Audio File Type	WAV
Channel	Mono

OBJECT

{{ App\Models\ApiRequestLog::VERIFY_OBJECT }}

Response

{{ App\Models\ApiRequestLog::VERIFY_RESPONSE_SUCCESS }}

Merchant Details

To find the details of the merchant, you can go back to the dashboard and go to the "Credentials" section.

There you can see Merchant details with the secret key and the hostname.You can copy the secret key by clicking the clipboard icon.

Secret Key Generation

To generate the new secret key, you have to go back to the dashboard, there you can go to "Secret Key" section and can generate a new key by clicking the "Generate Key" button. You can copy the key by clicking the clipboard icon.

NOTE: After generating a new key, the old key will no longer be a valid key.