Skip to content

Voice Biometrics User Groups

This describes the web services that manage voice biometric user groups.

Date formats

All dates are of the format YYYY-MM-DD_hh:mm:ss and are in Coordinated Universal Time (UTC).

Response content

All web services in this API return response content of type "application/json".

Note

 This is a low level API. For information on higher level APIs see the Web Services Language Wrappers

Authorisation

This API employs basic authentication, using your cloud account username, but unlike other web service APIs, requires a suitable Voice Biometric User Group Key rather than your account's API Access Key.
Username : cloudID/username (e.g. 1-2-0/bob@example.com)
Password : Voice Biometric User Group Key

List

List the user groups.

Request
URL : https://ws-[cloudID].aculabcloud.net/voice_biometrics/v1/user_group/list
Methods : GET, POST
Parameter Value Description
user_group_name optional the name of a user group.

Response

A JSON object containing a list of user group objects containing the following parameters:

Parameter Value Description
name string always
created string always
registrations integer always

Example

Request
https://ws-1-2-0.aculabcloud.net/voice_biometrics/v1/user_group/list
Response
{
    "user_groups": [
        {
            "name": BobsCompany",
            "created": "2021-01-15_08:56:24",
            "registrations": 7
        },
        {
            "name": "BillsCompany",
            "created": "2020-12-09_15:22:14",
            "registrations": 14
        }
    ]
}

Create

This creates a user group.

Request
URL : https://ws-[cloudID].aculabcloud.net/voice_biometrics/v1/user_group/create
Methods : GET, POST
Parameter Value Description
user_group_name required the name of the user group to create. The maximum length is 64 characters. Multiple consecutive spaces, and characters " ^ : are not supported.

Response

A JSON object containing the following parameters:

Parameter Value Description
created string always

Example

Request
https://ws-1-2-0.aculabcloud.net/voice_biometrics/v1/user_group/create?user_group_name=BobsCompany
Response
{
    "created": "2021-01-15_08:56:24"
}

Error Response
{
    "error": {
        "code": HTTP 403,
        "text": "Forbidden: user group BobsCompany is already present", 
        "link": "https://docs.cloud.aculab.com/Web_Services_API/web_service_voice_biometrics_user_groups/#create",
        "datetime": "2021-01-15_08:56:24"
    },
    "request": {
        "url": "/voice_biometrics/v1/user_group/create",
        "datetime": "2021-01-15_08:56:23"
    }
}

Delete

This deletes a user group.

Request
URL : https://ws-[cloudID].aculabcloud.net/voice_biometrics/v1/user_group/delete
Methods : GET, POST
Parameter Value Description
user_group_name required the name of the user group to delete.

Response

A JSON object containing the following parameters:

Parameter Value Description
deleted string always

Example

Request
https://ws-1-2-0.aculabcloud.net/voice_biometrics/v1/user_group/delete?user_group_name=BobsCompany

Response
{
    "deleted": "2021-01-15_08:56:24"
}
Error Response
{
    "error": {
        "code": HTTP 404,
        "text": "Not found: user group BobsCompany was not found", 
        "link": "https://docs.cloud.aculab.com/Web_Services_API/web_service_voice_biometrics_user_groups/#delete",
        "datetime": "2021-01-15_08:57:14"
    },
    "request": {
        "url": "/voice_biometrics/v1/user_group/delete",
        "datetime": "2021-01-15_08:57:13"
    }
}