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

API Фоток:

Войти

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

Получение данных альбома

Авторизация

Не требуется.

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

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

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

  1. Получить из сервисного документа адрес коллекции альбомов.
  2. Выполнить GET-запрос по полученному адресу коллекции альбомов.
  3. Из полученного Atom Feed коллекции взять ссылку <link rel="self".. /> из описания нужного альбома.

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

Пример

Запрос на получение данных альбома:

GET /api/users/alekna/album/63988/ HTTP/1.1
Host: api-fotki.yandex.ru
Accept: application/atom+xml; type=entry
Authorization: OAuth eb1c5...

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

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

<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>Каникулы в Германии</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>
См. также

Ошибки

  • 401 Unauthorized, 403 Forbidden

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

  • 404 Not found

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

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