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

API Фоток:

Войти

В формате PDF
← Ctrl предыдущаяследующая Ctrl →

Получение данных коллекции

Авторизация

Требуется. Без авторизации не будет возвращена информация об альбомах, в которых нет фотографий с уровнем доступа public.

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

Нужно обратиться GET-запросом по адресу коллекции альбомов пользователя.

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

В случае успеха сервер возвращает 200 OK и Atom Feed коллекции альбомов пользователя.

Пример

Запрос на получение коллекции альбомов:

GET /api/users/alekna/albums/ HTTP/1.1
Host: api-fotki.yandex.ru
Authorization: OAuth eb1c5...

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

HTTP/1.1 200 OK
Content-Type: application/atom+xml; charset=utf-8; type=feed
 
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:app="http://www.w3.org/2007/app" xmlns:f="yandex:fotki">
  <id>urn:yandex:fotki:alekna:albums</id>
  <author>
    <name>alekna</name>
  </author>
  <title>alekna на Яндекс.Фотках</title>
  <updated>2009-01-27T11:57:33Z</updated>
  <link href="http://api-fotki.yandex.ru/api/users/alekna/albums/" rel="self" />
  <link href="http://fotki.yandex.ru/users/alekna/albums/" rel="alternate" />
  <entry>
    <id>urn:yandex:fotki:alekna:album:63988</id>
    <author>
      <name>alekna</name>
    </author>
    <title>Каникулы в Германии</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://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>
  <entry>...</entry>
  <entry>...</entry>
  ...
  <entry>...</entry>
</feed>

Ответ сервера представляет собой RSS-фид.

Выдача элементов коллекции осуществляется постранично (см. Постраничная выдача коллекций).

Построение иерархии альбомов

Иерархия альбомов поддерживается с помощью ссылок альбомов на родительские альбомы. Эти ссылки указаны в элементах <link ... rel="album"> в Atom Entry альбомов, аналогично тому, как фотографии содержат ссылки на содержащий их альбом.

В выдаче API коллекция альбомов представлена линейным списком. Чтобы выстроить альбомную иерархию, нужно прочитать всю коллекцию альбомов, просмотреть каждый Entry-элемент и выстроить иерархию по ссылкам на родительские альбомы.

См. также

Ошибки

  • 401 Unauthorized, 403 Forbidden

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

  • 400 Bad Request, 404 Not Found

    Ошибки листания.

  • 404 Not found

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

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