Получение всех аудиторий

Описание

Возвращает список всех аудиторий и общее количество аудиторий в системе. Подходит для построения списка в интерфейсе и постраничного вывода через limit и offset.

URL-адрес

GET/audience

Параметры запроса

Параметр	Где	Тип	Пример	Обязательный	Описание
limit	query	integer	50	Нет	Сколько аудиторий вернуть за запрос
offset	query	integer	0	Нет	Смещение для постраничного получения

Пример запроса

bash

curl -X GET "https://example.com/api/audience?limit=50&offset=0" \
  -H "X-MOODREC-API: <token>" \
  -H "Accept: application/json"

Пример ответа

json

{
  "audiences": [
    {
      "aid": 42,
      "name": "Тестовая аудитория",
      "description": "Описание аудитории",
      "last_import_status": "success",
      "create_time": 2740125112,
      "update_time": 2740125112
    }
  ],
  "count": 1
}

Возвращаемые параметры

Параметр	Тип	Описание
audiences	array	Список аудиторий
audiences[].aid	integer	Уникальный идентификатор аудитории (0–65535)
audiences[].name	string	Название аудитории
audiences[].description	string	Описание аудитории
audiences[].last_import_status	string	Статус последнего импорта (если доступен)
audiences[].create_time	integer	Время создания в Unix
audiences[].update_time	integer	Время последнего обновления в Unix
count	integer	Общее количество аудиторий