Получить список сторисов

Получить список сторисов#

Ручка#

POST /stories/v1/fetch_stories

Полный адрес в сети#

Среда	URL
Dev	`https://gateway.devterra.ru/admin/stories/v1/fetch_stories`
Prod	`https://mobile-api.terraprod.ru/admin/stories/v1/fetch_stories`

Пример тела запроса#

{
  "filters": {
    "fixed": true,
    "requiredToShow": false,
    "forAll": true,
    "mustShowTo": "2026-09-01T00:00:00Z",
    "userCreator": "0a4cf923-3014-47fb-9c90-64f4c707f4f1",
    "orderByDesc": true,
    "cityId": 1
  },
  "pagination": {
    "limit": 10,
    "page": 1
  }
}

Поле	Тип	Описание	Обязательность
filters	object	Фильтры списка сторисов.	Нет
pagination	object	Параметры пагинации.	Нет

Объект filters#

Поле	Тип	Описание	Обязательность
fixed	bool	Фильтр по закрепленным или незакрепленным сторисам.	Нет
requiredToShow	bool	Фильтр по обязательности показа.	Нет
forAll	bool	Фильтр по доступности всем пользователям.	Нет
mustShowTo	time.Time	Фильтр по дате обязательного показа.	Нет
userCreator	string	Фильтр по UUID создателя сториса.	Нет
orderByDesc	bool	Сортировать список по убыванию.	Нет
cityId	int32	Фильтр по ID города, должен быть больше 0.	Нет

Объект pagination#

Поле	Тип	Описание	Обязательность
limit	int32	Количество элементов на странице. Допустимо `-1` для запроса без ограничения.	Нет
page	int32	Номер страницы, должен быть больше 0.	Нет

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

{
  "result": [
    {
      "uuid": "61bc5b6f-ea0d-4e8b-9c67-2e706071a064",
      "fixed": true,
      "requiredToShow": false,
      "forAll": true,
      "mustToShow": "2026-09-01T00:00:00Z",
      "userCreator": "0a4cf923-3014-47fb-9c90-64f4c707f4f1",
      "pages": [],
      "reactions": [],
      "createdAt": "2026-08-20T10:00:00Z",
      "updatedAt": "2026-08-20T10:00:00Z",
      "deletedAt": null,
      "name": "Онбординг",
      "cover": {
        "imageURL": "https://cdn.terra.ru/stories/cover.png",
        "x": 0,
        "y": 0,
        "width": 1080,
        "height": 1920
      }
    }
  ],
  "pagination": {
    "itemsPerPage": 10,
    "totalItems": 1,
    "currentPage": 1,
    "totalPages": 1
  }
}

Поле	Тип	Описание	Обязательность
result	[]object	Список сторисов.	Нет
pagination	object	Информация о пагинации.	Нет

Объект result#

Поле	Тип	Описание	Обязательность
uuid	string	UUID сториса.	Нет
fixed	bool	Закреплен ли сторис.	Нет
requiredToShow	bool	Обязателен ли сторис к показу.	Нет
forAll	bool	Доступен ли сторис всем пользователям.	Нет
mustToShow	time.Time	Дата и время, до которых сторис должен показываться.	Нет
userCreator	string	UUID пользователя, создавшего сторис.	Нет
pages	[]object	Страницы сториса.	Нет
reactions	[]object	Реакции пользователей на сторис.	Нет
createdAt	time.Time	Дата создания сториса.	Нет
updatedAt	time.Time	Дата последнего обновления сториса.	Нет
deletedAt	time.Time	Дата удаления сториса.	Нет
name	string	Название сториса.	Нет
cover	object	Обложка сториса.	Нет

Объект cover#

Поле	Тип	Описание	Обязательность
imageURL	string	URL изображения обложки.	Нет
x	int32	Координата X области обложки.	Нет
y	int32	Координата Y области обложки.	Нет
width	int32	Ширина области обложки.	Нет
height	int32	Высота области обложки.	Нет

Объект pagination#

Поле	Тип	Описание	Обязательность
itemsPerPage	int32	Количество элементов на странице.	Нет
totalItems	int32	Общее количество элементов.	Нет
currentPage	int32	Текущая страница.	Нет
totalPages	int32	Общее количество страниц.	Нет