Метод GetList
Примените метод GetList для получения списка ресурсов голосовых SMS по заданным параметрам.
Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:
POST: https://api.exolve.ru/voice-message/v1/GetList
Авторизация
Передайте следующие Заголовки HTTP для успешной авторизации.
| Имя | Тип | Описание |
|---|---|---|
| Authorization | string | API-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения |
Входные параметры
| Параметр | Тип | Описание |
|---|---|---|
| limit | int64 | лимит выводимых строк |
| offset | int64 | номер строки, с которой начинать выборку (начинается с 0) |
| name | string | название ресурса голосового сообщения |
| id | string | идентификатор ресурса голосового сообщения |
Выходные параметры
| Параметр | Тип | Описание |
|---|---|---|
| voice_messages | array VoiceMessages | информация об услугах голосового сообщения |
| total | unit64 | общее количество голосовых сообщений с применёнными фильтрами |
VoiceMessages
| Параметр | Тип | Описание |
|---|---|---|
| id | string | идентификатор ресурса голосового сообщения |
| name | string | название ресурса голосового сообщения |
| created_at | string | дата создания ресурса голосового сообщения в формате RFC-3339 / ISO-8601 |
Примеры
Входные параметры:
{
"limit": "10",
"offset": "0"
}
Выходные параметры:
{
"voice_messages": [
{
"id": "8ef688fb-915f-4f31-9ab7-9560b8a39280",
"name": "Голосовое сообщение 1",
"created_at": "2026-06-28T19:01:58.452Z"
},
{
"id": "9a726975-4aa3-4a48-9b05-31a0c4967eca",
"name": "Голосовое сообщение 2",
"created_at": "2026-06-28T19:30:55.107Z"
}
],
"total": "2"
}
Возможные ошибки
| Код | Статус | Пример сообщения | Описание |
|---|---|---|---|
| 400 | Bad Request | “error”: “invalid GetListRequest.Id: value length must be 36 runes; invalid GetListRequest.Id: value must be a valid UUID | caused by: invalid uuid format” |
| 401 | Unauthorized | failed to parse token | невалидный API-ключ |