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

В формате PDF

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

Авторизация

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

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

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

Примечание
Адрес коллекции фотографий тега определяется ссылкой <link rel="photos" ... />, содержащейся в Atom Entry тега (см. Получение данных тега).

В случае успеха сервер возвращает 200 OK и Atom Feed коллекции фотографий.

Пример

Запрос на получение данных коллекции фотографий тега:

GET /api/users/alena/tag/природа/photos/ HTTP/1.1
Host: api-fotki.yandex.ru
Content-Type: application/atom+xml; charset=utf-8; type=feed
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"
 xmlns:georss="http://www.georss.org/georss">
  <id>urn:yandex:fotki:alekna:photos</id>
  <author>
    <name>alekna</name>
  </author>
  <title>alekna на Яндекс.Фотках</title>
  <updated>2011-04-24T11:46:32Z</updated>
  <link href="http://api-fotki.yandex.ru/api/users/alekna/photos/" rel="self" />
  <link href="http://fotki.yandex.ru/users/alekna/" rel="alternate" />
  <entry>
    <id>urn:yandex:fotki:alekna:photo:406189</id>
    <author>
      <name>alekna</name>
    </author>
    <title>Закат</title>
    <link href="http://api-fotki.yandex.ru/api/users/alekna/photo/406189/" rel="self" />
    <link href="http://api-fotki.yandex.ru/api/users/alekna/photo/406189/" rel="edit" />
    <link href="http://fotki.yandex.ru/users/alekna/view/406189/" rel="alternate" />
    <link href="http://img-fotki.yandex.ru/get/4404/alekna.0/0_632ad_9b489da5_orig" rel="edit-media" />
    <link href="http://api-fotki.yandex.ru/api/users/alekna/album/157505/" rel="album" />
    <published>2011-02-21T10:41:28Z</published>
    <app:edited>2011-04-24T11:46:32Z</app:edited>
    <updated>2011-04-24T11:46:32Z</updated>
    <f:access value="private" />
    <f:xxx value="false" />
    <f:hide_original value="false" />
    <f:disable_comments value="false" />
    <f:img height="75" href="http://img-fotki.yandex.ru/get/4404/alekna.0/0_632ad_9b489da5_XXS" size="XXS" width="75" />
    <f:img height="453" href="http://img-fotki.yandex.ru/get/4404/alekna.0/0_632ad_9b489da5_XL" size="XL" width="604" />
    <f:img height="225" href="http://img-fotki.yandex.ru/get/4404/alekna.0/0_632ad_9b489da5_M" size="M" width="300" />
    <f:img height="375" href="http://img-fotki.yandex.ru/get/4404/alekna.0/0_632ad_9b489da5_L" size="L" width="500" />
    <f:img height="50" href="http://img-fotki.yandex.ru/get/4404/alekna.0/0_632ad_9b489da5_XXXS" size="XXXS" width="50" />
    <f:img height="113" href="http://img-fotki.yandex.ru/get/4404/alekna.0/0_632ad_9b489da5_S" size="S" width="150" />
    <f:img height="75" href="http://img-fotki.yandex.ru/get/4404/alekna.0/0_632ad_9b489da5_XS" size="XS" width="100" />
    <f:img height="453" href="http://img-fotki.yandex.ru/get/4404/alekna.0/0_632ad_9b489da5_orig" size="orig" width="604" />
    <category scheme="http://api-fotki.yandex.ru/api/users/alekna/tags/" term="природа" />
    <content src="http://img-fotki.yandex.ru/get/4404/alekna.0/0_632ad_9b489da5_orig" type="image/*" />
  </entry>
  <entry> ...  </entry>
          ...
  <entry> ...  </entry>
</feed>

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

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

  • 401 Unauthorized, 403 Forbidden

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

  • 400 Bad Request, 404 Not Found

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

  • 404 Not found

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

    User {login} not found или Tag {tag} not found.