Создать сторис

Создать сторис

Ручка

POST /stories/v1/create_stories

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

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

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

{
  "fixed": true,
  "requiredToShow": false,
  "forAll": false,
  "mustShowTo": "2026-09-01T00:00:00Z",
  "pages": [
    {
      "pageNumber": 1,
      "components": [
        {
          "componentType": 0,
          "headerText": "Добро пожаловать",
          "deepLink": "terra://stories/start",
          "transition": {
            "type": 1,
            "typeName": "deeplink",
            "value": {
              "url": "terra://stories/start"
            }
          }
        }
      ]
    }
  ],
  "userUUIDs": [
    "9b97dd83-416a-42b3-9105-085a0de70ba4"
  ],
  "name": "Онбординг",
  "cover": {
    "imageURL": "https://cdn.terra.ru/stories/cover.png",
    "x": 0,
    "y": 0,
    "width": 1080,
    "height": 1920
  },
  "cityID": 1
}

Поле	Тип	Описание	Обязательность
fixed	bool	Закрепляет сторис.	Нет
requiredToShow	bool	Делает сторис обязательным к показу.	Нет
forAll	bool	Делает сторис доступным всем пользователям.	Нет
mustShowTo	time.Time	Дата и время, до которых сторис должен показываться.	Нет
pages	[]object	Страницы, создаваемые вместе со сторисом.	Нет
userUUIDs	[]string	UUID пользователей, которым нужно явно прикрепить сторис.	Нет
name	string	Название сториса.	Да
cover	object	Обложка сториса.	Нет
cityID	int32	ID города, должен быть больше 0.	Нет

Объект pages

Поле	Тип	Описание	Обязательность
pageNumber	int32	Порядковый номер страницы, должен быть больше 0.	Да
components	[]object	Компоненты страницы.	Нет

Объект components

Поле	Тип	Описание	Обязательность
componentType	int32	Тип компонента: 0 - BACKGROUND, 1 - BUTTON, 2 - PRIMARY_BUTTON, 3 - SECONDARY_BUTTON.	Да
headerText	string	Текст заголовка или кнопки компонента.	Нет
deepLink	string	Deep link компонента.	Нет
transition	object	Настройки перехода компонента.	Нет

Объект transition

Поле	Тип	Описание	Обязательность
type	int32	Числовой тип перехода.	Нет
typeName	string	Текстовое название типа перехода.	Нет
value	map[string]string	Дополнительные параметры перехода в формате ключ-значение.	Нет

Объект cover

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

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

{
  "stories": {
    "uuid": "61bc5b6f-ea0d-4e8b-9c67-2e706071a064",
    "fixed": true,
    "requiredToShow": false,
    "forAll": false,
    "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
    }
  }
}

Поле	Тип	Описание	Обязательность
stories	object	Созданный сторис.	Нет

Объект stories

Поле	Тип	Описание	Обязательность
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	Высота области обложки.	Нет