ВебмастерМетрикаВиджетыРекламная сетьДиректПоиск для сайтаAPI
Войти

В формате PDF

Редактирование альбома

Авторизация

Требуется. Данную операцию может выполнить только владелец альбома.

Порядок действий

  1. Получить Atom Entry альбома.

    Адрес альбома содержится в атрибуте href элемента <link rel="self" ... />.

  2. Изменить нужные атрибуты.
  3. Сохранить измененный Atom Entry PUT-запросом по адресу ресурса альбома для редактирования. Этот адрес определяется ссылкой <link rel="edit" ... />, содержащейся в Atom Entry альбома.
Внимание!
Каждый раз перед редактированием альбома настоятельно рекомендуется получать его Atom Entry.

В случае успеха сервер возвращает 200 OK и Atom Entry измененного альбома.

Пример

Сохранение измененных данных альбома (комментарии не являются частью запроса):

PUT /api/users/alekna/album/63988/ 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:app="http://www.w3.org/2007/app" xmlns:f="yandex:fotki">
  <id>urn:yandex:fotki:alekna:album:63988</id>
  <author>
    <name>alekna</name>
  </author>
  <!-- старое название: "Каникулы в Германии" -->
  <title>Каникулы в Германии (лето 2008)</title>
  <!-- старое описание: "Наша школьная поездка в Германию" -->
  <summary>Наша школьная поездка в Германию после сдачи выпускных экзаменов</summary>
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/63988/" rel="self" />
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/63988/" rel="edit" />
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/63988/photos/" rel="photos" />
  <!--Альбом перемещен в альбом с номером 169752 -->
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/169752/" rel="album" />
  <link href="http://fotki.yandex.ru/users/alekna/album/63988/" rel="alternate" />
  <published>2009-01-27T11:52:12Z</published>
  <app:edited>2009-01-27T11:57:33Z</app:edited>
  <updated>2009-01-27T11:57:33Z</updated>
  <f:protected value="false" />
  <f:image-count value="10" />
</entry>

Ответ сервера:

HTTP/1.1 200 OK 
Location: http://api-fotki.yandex.ru/api/users/alekna/album/63988/
Content-Location: http://fotki.yandex.ru/users/alekna/album/63988/
Content-Type: application/atom+xml; charset=utf-8; type=entry

<entry xmlns="http://www.w3.org/2005/Atom" xmlns:app="http://www.w3.org/2007/app" xmlns:f="yandex:fotki">
  <id>urn:yandex:fotki:alekna:album:63988</id>
  <author>
    <name>alekna</name>
  </author>
  <title>Каникулы в Германии (лето 2008)</title>
  <summary>Наша школьная поездка в Германию после сдачи выпускных экзаменов</summary>
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/63988/" rel="self" />
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/63988/" rel="edit" />
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/63988/photos/" rel="photos" />
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/169752/" rel="album">
  <link href="http://fotki.yandex.ru/users/alekna/album/63988/" rel="alternate" />
  <published>2009-01-27T11:52:12Z</published>
  <app:edited>2009-01-27T11:57:33Z</app:edited>
  <updated>2009-01-27T11:57:33Z</updated>
  <f:protected value="false" />
  <f:image-count value="10" />
</entry>

Менять можно следующие атрибуты альбома:

  • atom:title

    Название альбома. Не может быть пустой строкой.

  • atom:summary

    Описание альбома.

  • f:password

    Пароль к альбому. Для удаления пароля нужно передать пустую строку.

  • atom:link[@rel="album"]

    Ссылка на родительский альбом. При изменении этой ссылки альбом перемещается в другой альбом. Если удалить этот атрибут, альбом становится альбомом верхнего уровня.

Остальные атрибуты не подлежат редактированию и должны передаваться без изменений.

Возможные ошибки

  • 401 Unauthorized, 403 Forbidden

    Ошибки авторизации.

  • 400 Bad Request

    Переданный клиентским приложением XML не является валидным Atom Entry альбома или содержит пустой параметр atom:title.

  • 403 Forbidden

    Для доступа к альбому требуется пароль.

  • 404 Not found

    Такого пользователя или альбома не существует. В теле ответа отдается:

    User {login} not found или Album {album_id} not found.

  • 415 Unsupported Media Type

    Заголовок Content-Type содержит тип, отличный от типа Atom Entry.