Добавление нового альбома

Авторизация

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

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

1. Создать Atom Entry нового альбома, содержащий изменяемые атрибуты альбома.
2. Передать созданный Atom Entry POST-запросом по адресу коллекции альбомов пользователя.

Адрес коллекции альбомов пользователя определяется сервисным документом.

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

POST /api/users/alekna/albums/ HTTP/1.1
Host: api-fotki.yandex.ru
Content-Type: application/atom+xml; charset=utf-8; type=entry
Authorization: OAuth eb1c55f...

<entry xmlns="http://www.w3.org/2005/Atom" xmlns:f="yandex:fotki">
  <title>Природа</title>
  <summary>Фотографии природы с разных источников</summary>
</entry>

HTTP/1.1 201 Created
Content-Type: application/atom+xml; type=entry
Location: http://api-fotki.yandex.ru/api/users/alekna/album/168649/
Content-Location: http://fotki.yandex.ru/users/alekna/album/168649/

<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:168649</id>
  <author>
    <name>alekna</name>
  </author>
  <title>Природа</title>
  <summary>Фотографии природы с разных источников</summary>
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/168649/" rel="self" />
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/168649/" rel="edit" />
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/168649/photos/" rel="photos" />
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/168649/photos.ymapsml/" rel="ymapsml" />
  <link href="http://fotki.yandex.ru/users/alekna/album/168649/" rel="alternate" />
  <published>2011-05-10T11:44:42Z</published>
  <app:edited>2011-05-10T11:44:42Z</app:edited>
  <updated>2011-05-10T11:44:42Z</updated>
  <f:protected value="false" />
  <f:image-count value="0" />
</entry>

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

• atom:title

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

• atom:summary

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

• f:password

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

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

  Ссылка на родительский альбом, в который будет добавлен исходный. Если атрибут не указывать, то альбом станет корневым. Корневых альбомов бывает несколько.

Значения остальных атрибутов передавать не нужно: сервер генерирует их автоматически и передает клиентскому приложению в ответе. При этом любые значения этих атрибутов, указанные клиентским приложением в запросе, будут проигнорированы.

Ошибки

• 401 Unauthorized, 403 Forbidden

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

• 400 Bad Request

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

• 400 Empty Album Title

  Обязательный параметр atom:title пустой.

• 404 Not found

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

  User {login} not found.

• 405 Method Not Allowed

  Клиентское приложение попыталось вызвать метод, отсутствующий в списке разрешенных для данного адреса. В заголовке будет содержаться список разрешенных методов.

• 415 Unsupported Media Type

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