API Яндекс.Фоток. Руководство разработчика: Сервисный документ

Типичным сценарием начала работы клиентского приложения является получение сервисного документа. Сервисный документ содержит ссылки на главные коллекции пользователя: на общую коллекцию фотографий, на коллекцию альбомов и на коллекцию тегов. Также сервисный документ содержит информацию о поддерживаемых коллекциями MIME-типах POST-запросов.

Сервисный документ находится по адресу

http://api-fotki.yandex.ru/api/users/{login}/, где {login} - логин пользователя на Яндексе.

Если имеется авторизационный токен, то адрес сервисного документа также можно узнать, обратившись к серверу по адресу http://api-fotki.yandex.ru/api/me/, после чего сервер произведет редирект на сервисный документ.

Пример

Получение серсивного документа для пользователя «alekna»:

GET http://api-fotki.yandex.ru/api/users/alekna/ HTTP/1.1
Host: api-fotki.yandex.ru

Сервер возвращает сервисный документ:

HTTP/1.1 200 OK 
Content-Type: application/atomsvc+xml; charset=utf-8

<service xmlns:app="http://www.w3.org/2007/app" xmlns:atom="http://www.w3.org/2005/Atom">
  <workspace>
    <atom:title>alekna на Яндекс.Фотках</atom:title>
    <collection href="http://api-fotki.yandex.ru/api/users/alekna/albums/" id="album-list">
      <atom:title>Все альбомы пользователя alekna</atom:title>
      <accept>application/atom+xml; type=entry, application/json; type=entry</accept>
    </collection>
    <collection href="http://api-fotki.yandex.ru/api/users/alekna/photos/" id="photo-list">
      <atom:title>Все фотографии пользователя alekna</atom:title>
      <accept>image/*</accept>
      <categories scheme="http://api-fotki.yandex.ru/api/users/alekna/tags/" />
    </collection>
    <collection href="http://api-fotki.yandex.ru/api/users/alekna/tags/" id="tag-list">
      <atom:title>Все теги пользователя alekna</atom:title>
      <accept />
    </collection>
  </workspace>
</service>

API Фоток:

Сервисный документ

Пример