API Яндекс.Фоток. Руководство разработчика: Создание нового альбома

Для создания нового альбома необходимо отправить POST-запрос по адресу коллекции альбомов пользователя. Адрес этой коллекции содержится в сервисном документе в элементе collection с идентификатором id="album-list" (см. Начало работы).

В теле запроса указывается информация о новом альбоме в формате, подобном формату Atom Entry. Достаточно передать только элемент atom:title (название альбома). Также можно передать и другие атрибуты (см. Список доступных атрибутов).

Добавляем новый альбом «Путешествия»:

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>
</entry>

Сервер возвращает представление ресурса созданного альбома:

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

<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:168628</id>
  <author>
    <name>alekna</name>
  </author>
  <title>Путешествия</title>
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/168628/" rel="self" />
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/168628/" rel="edit" />
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/168628/photos/" rel="photos" />
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/168628/photos.ymapsml/" rel="ymapsml" />
  <link href="http://fotki.yandex.ru/users/alekna/album/168628/" rel="alternate" />
  <published>2011-05-10T10:04:31Z</published>
  <app:edited>2011-05-10T10:04:31Z</app:edited>
  <updated>2011-05-10T10:04:31Z</updated>
  <f:protected value="false" />
  <f:image-count value="0" />
</entry>

После отправки POST-запроса на сервере создался новый ресурс с уникальным идентификатором urn:yandex:fotki:alekna:album:168628. Идентификатор однозначно определяет альбом. Адрес альбома указывается в ответе сервера в заголовке Location и в теле ответа в атрибуте href элемента <link href="..." rel="self" />. Этот адрес необходим для получения данных альбома в дальнейшем.

Следующим шагом добавим изображения в альбом. Загрузка изображения в альбом выполняется отправкой файла изображения по адресу коллекции коллекцию фотографий альбома. Этот адрес содержится в Atom Entry альбома в атрибуте href элемента <link .. rel = "photos">. Для добавления изображения в альбом «Путешествия» из полученного Atom Entry извлекаем адрес коллекции фотографий:

http://api-fotki.yandex.ru/api/users/alekna/album/168628/photos/.

Далее - Загрузка изображения в новый альбом.

API Фоток:

Создание нового альбома