Редактирование тега заключается в его переименовании. При редактировании тега изменяется фотография (меняется атрибут atom:category).
Авторизация
Требуется.
Порядок действий
- Получить Atom Entry тега.
Адрес тега определяется ссылкой <link rel="edit" ... />, содержащейся в Atom Entry тега (см. Получение данных тега).
- Изменить атрибут atom:title.
- Сохранить измененный Atom Entry PUT-запросом по адресу ресурса тега.
Идентификатором тега является его имя. Тег не имеет числового идентификатора.
В случае успеха сервер возвращает 200 OK и Atom Entry измененного тега.
Пример
Сохранение измененных данных тега:
PUT /api/users/alekna/tag/природа/ HTTP/1.1
Host: api-fotki.yandex.ru
Content-Type: application/atom+xml; charset=utf-8; type=entry
Authorization: OAuth eb1c5...
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:f="yandex:fotki">
<id>urn:yandex:fotki:alekna:tag:природа</id>
<!-- старое название: "природа" -->
<title>природа России</title>
<link href="http://api-fotki.yandex.ru/api/users/alekna/tag/природа/" rel="self" />
<link href="http://api-fotki.yandex.ru/api/users/alekna/tag/природа/" rel="edit" />
<link href="http://fotki.yandex.ru/users/alekna/tags/природа/" rel="alternate" />
<link href="http://api-fotki.yandex.ru/api/users/alekna/tag/природа/photos/" rel="photos" />
<updated>2011-04-07T15:05:53Z</updated>
<f:image-count value="2" />
</entry>
Ответ сервера:
HTTP/1.1 200 OK
Content-Type: application/atom+xml; charset=utf-8; type=entry
Location: http://api-fotki.yandex.ru/api/users/alekna/tag/природа России/
Content-Location: http://fotki.yandex.ru/users/alekna/tags/природа России/
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:f="yandex:fotki">
<id>urn:yandex:fotki:alekna:tag:природа России</id>
<title>природа России</title>
<link href="http://api-fotki.yandex.ru/api/users/alekna/tag/природа России/" rel="self" />
<link href="http://api-fotki.yandex.ru/api/users/alekna/tag/природа России/" rel="edit" />
<link href="http://fotki.yandex.ru/users/alekna/tags/природа России/" rel="alternate" />
<link href="http://api-fotki.yandex.ru/api/users/alekna/tag/природа России/photos/" rel="photos" />
<updated>2011-04-07T15:05:53Z</updated>
<f:image-count value="2" />
</entry>
Можно изменять только атрибут atom:title - название тега. Остальные атрибуты не подлежат редактированию и должны передаваться без изменений.
Возможные ошибки
-
401 Unauthorized, 403 Forbidden
Ошибки авторизации.
-
400 Bad Request
Переданный клиентским приложением XML не является валидным Atom Entry альбома или содержит пустой параметр atom:title.
-
404 Not found
Такого пользователя или тега не существует. В теле ответа отдается:
User {login} not found или Tag not found.
-
415 Unsupported Media Type
Заголовок Content-Type содержит тип, отличный от типа Atom Entry.
