Авторизация
Требуется для фотографий с уровнем доступа private и friends.
Не требуется для фотографий с уровнем доступа public.
Порядок действий
Нужно обратиться GET-запросом по адресу ресурса фотографии.
Адрес ресурса фотографии определяется ссылкой <link rel="self".. />, содержащейся в Atom Entry фотографии. Чтобы узнать эту ссылку, нужно:
- Получить из сервисного документа адрес общей коллекции фотографий.
- Выполнить GET-запрос по полученному адресу общей коллекции фотографий.
- Из полученного Atom Feed коллекции взять ссылку <link rel="self".. /> из описания нужной фотографии.
В случае успеха сервер возвращает 200 OК и Atom Entry фотографии.
Пример
Запрос на получение данных фотографии:
GET /api/users/alekna/photo/126746/ 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
<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:photo:126746</id>
<title>Я на фоне Бранденбургских ворот</title>
<author>
<name>alekna</name>
</author>
<link href="http://api-fotki.yandex.ru/api/users/alekna/photo/126746/" rel="self" />
<link href="http://api-fotki.yandex.ru/api/users/alekna/photo/126746/" rel="edit" />
<link href="http://fotki.yandex.ru/users/alekna/view/126746/" rel="alternate" />
<link href="http://img-fotki.yandex.ru/get/3306/alekna.0/0_1ef1a_9a6e7171_XL" rel="edit-media" />
<link href="http://api-fotki.yandex.ru/api/users/alekna/album/63988/" rel="album" />
<published>2009-01-27T11:57:32Z</published>
<app:edited>2009-01-27T11:57:32Z</app:edited>
<updated>2009-01-27T11:57:32Z</updated>
<f:created>2008-07-10T22:02:40</f:created>
<f:access value="private" />
<f:xxx value="false" />
<f:hide_original value="false" />
<f:disable_comments value="false" />
<content src="http://img-fotki.yandex.ru/get/3306/alekna.0/0_1ef1a_9a6e7171_XL" type="image/*" />
</entry>
Возможные ошибки
