Авторизация
Требуется. Без авторизации будет возвращена информация только о фотографиях с уровнем доступа "для всех".
Порядок действий
Нужно обратиться GET-запросом по адресу коллекции фотографий тега.
В случае успеха сервер возвращает 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>
Выдача элементов коллекции осуществляется постранично (см. Постраничная выдача коллекций).
Возможные ошибки