folders

Создать папку

Создать папку и, если нужно, сразу положить в неё объекты.

object_ids — это полный состав, а не добавление: список заменяет прежний целиком. Недоступные идентификаторы не валят запрос, а возвращаются в ignored_object_ids.

post/v3/folders

Request

  • Base URL: https://api.rewio.ru
  • URL: https://api.rewio.ru/v3/folders
  • Auth: API key in header X-API-Key

Headers

Idempotency-Keystring nullable

Request body

namestring required

Название папки.

parent_folder_idinteger nullable

Родительская папка. Глубина ограничена двумя ступенями.

object_idsinteger[] nullable

Состав папки. Присылается целиком: список полностью заменяет прежний. Недоступные идентификаторы возвращаются в ignored_object_ids.

Response

Successful Response

idinteger required

Идентификатор папки.

user_idinteger required

Номер клиента – владельца папки.

namestring required

Название папки.

created_atstring date-time required

Момент создания папки (UTC, ISO 8601).

parent_folder_idinteger nullable

Родительская папка; null у папки верхнего уровня.

review_countinteger nullable

Сколько отзывов в ленте папки (GET /v3/reviews?folder_id=): объекты папки и её подпапок, отзыв общей для двух объектов ссылки считается один раз.

is_demoboolean

Папка примеров, которую кабинет кладёт новому клиенту.

ignored_object_idsinteger[]

Идентификаторы из присланного object_ids, которые в состав не попали: чужие, удалённые или несуществующие объекты. Запрос при этом выполняется — остальные объекты кладутся в папку.

Changes

No recorded changes to this operation across all 1 revision of this API.