Править служебные метки нескольких фото
const url = 'https://app.photo-otchet.ru/api/v2/salons/1/photos/service-tags';const options = { method: 'PATCH', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"photo_ids":[1],"add_tag_ids":[1],"remove_tag_ids":[1]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PATCH \ --url https://app.photo-otchet.ru/api/v2/salons/1/photos/service-tags \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "photo_ids": [ 1 ], "add_tag_ids": [ 1 ], "remove_tag_ids": [ 1 ] }'Правка пачки служебных меток — теми же правилами, что и у тегов мастера.
Параметры
Заголовок раздела « Parameters »Параметры пути
Заголовок раздела « Path Parameters »Салон
Салон
Тело запросаобязательно
Заголовок раздела « Request Bodyrequired »Правка тегов пачки фото: что поставить всем и что снять со всех.
object
Какие фото правим
Поставить всем этим фото; архивные нельзя
Снять со всех этих фото; архивные снимать можно
Пример сгенерирован
{ "photo_ids": [ 1 ], "add_tag_ids": [ 1 ], "remove_tag_ids": [ 1 ]}Метки поправлены у всех перечисленных работ
Нет действующего входа: нет куки или токена, сессия истекла, токен отозван
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "reason": "unauthenticated"}Срок салона кончился: reason: salon_expired, в теле state и paid_until
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "reason": "unauthenticated"}Прав на это действие нет: не хватает политики или запрещён способ входа
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "reason": "unauthenticated"}Фото нет или оно не видно
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "detail": "Фото не найдены: [42, 7]"}Тег не подходит
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Примеры
Нет такого тега
{ "detail": "Тегов с id [7] нет в справочнике"}Архивный тег
{ "detail": "Теги с id [3] в архиве: назначить их нельзя, только снять"}Направление в архиве
{ "detail": "Теги с id [5] из направлений в архиве: назначить их нельзя, только снять"}Чужое направление
{ "detail": "Теги с id [9] из направлений, которые вам не назначены: поставить их нельзя, только снять"}Салон заблокирован оператором: reason: salon_blocked, причина в blocked_reason
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "reason": "unauthenticated"}Документы не приняты
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "detail": "Примите документы, чтобы продолжить"}