Авторизация
Не требуется.
Порядок действий
Нужно обратиться GET-запросом по адресу ресурса тега.
Адрес ресурса тега находится в атрибуте href элемента <link rel="self".. /> . Чтобы узнать этот адрес, нужно:
- Получить из сервисного документа адрес коллекции тегов.
- Выполнить GET-запрос по полученному адресу коллекции тегов.
- Из полученного Atom Feed коллекции взять ссылку <link rel="self".. /> из описания нужного тега.
Идентификатором тега является его имя. Тег не имеет числового идентификатора.
В случае успеха сервер возвращает 200 OК и Atom Entry тега.
GET /api/users/alekna/tag/природа/ 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=entry
Location: http://api-fotki.yandex.ru/api/users/alekna/tag/природа/
Content-Location: http://fotki.yandex.ru/users/alekna/tags/природа/
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:f="yandex:fotki">
<id>urn:yandex:fotki:alekna:tag:природа</id>
<title>природа</title>
<link href="http://api-fotki.yandex.ru/api/users/alekna/tag/природа/" rel="self" />
<link href="http://api-fotki.yandex.ru/api/users/alekna/tag/природа/" rel="edit" />
<link href="http://fotki.yandex.ru/users/alekna/tags/природа/" rel="alternate" />
<link href="http://api-fotki.yandex.ru/api/users/alekna/tag/природа/photos/" rel="photos" />
<updated>2011-04-07T15:05:53Z</updated>
<f:image-count value="2" />
</entry>
Возможные ошибки
