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

Подробное описание сервисного документа API Фоток.

Сервисный документ содержит информацию об основных коллекциях пользователя.

Корнем сервисного документа является элемент-контейнер app:service. Он содержит рабочую область app:workspace, в которой находятся коллекции ресурсов, принадлежащие некоторому пользователю Яндекс.Фоток.

Рабочая область содержит название atom:title вида "{author}на Яндекс.Фотках", а также принадлежащие данному пользователю коллекции ресурсов app:collection:

коллекция альбомов пользователя;
общая коллекция фотографий пользователя;
коллекция тегов.

Для каждой коллекции указываются ее адрес, название и тип содержащихся в ней ресурсов.

Коллекции фотографий отдельных альбомов не указываются в сервисном документе. Их адреса можно узнать из ссылок atom:link [@rel="photos"] в описаниях отдельных альбомов.

Пример сервисного документа:

<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 Фоток:

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