ВебмастерМетрикаВиджетыРекламная сетьДиректПоиск для сайтаAPI
ещё
Найти

API Фоток:

Войти

В формате PDF
← Ctrl предыдущаяследующая Ctrl →

Фотография

Подробное описание Atom Entry фотографии.

Atom Entry, используемый для описания фотографии, выглядит следующим образом:

<entry xmlns="http://www.w3.org/2005/Atom" xmlns:app="http://www.w3.org/2007/app" xmlns:f="yandex:fotki">
  <id>urn:yandex:fotki:maxum:photo:126746</id>
  <title>Я и Саша на фоне Бранденбургских ворот</title>
  <author>
    <name>maxum</name>
  </author>
  <link href="http://api-fotki.yandex.ru/api/users/maxum/photo/126746/" rel="self" />
  <link href="http://api-fotki.yandex.ru/api/users/maxum/photo/126746/" rel="edit" />
  <link href="http://fotki.yandex.ru/users/maxum/view/126746/" rel="alternate" />
  <link href="http://img-fotki.yandex.ru/get/3306/maxum.0/0_1ef1a_9a6e7171_XL" rel="edit-media" />
  <link href="http://api-fotki.yandex.ru/api/users/maxum/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/maxum.0/0_1ef1a_9a6e7171_XL" type="image/*" />
</entry>

В приведенном фрагменте содержатся следующие данные:

  • atom:id

    Идентификатор Atom Entry фотографии: urn:yandex:fotki:alekna:photo:126746

    Идентификатор является глобально уникальным и позволяет клиентскому приложению однозначно определить некоторый Atom Entry (например, с целью выявления дубликатов при постраничной выдаче коллекций).

  • atom:title

    Название фотографии: Я и Саша на фоне Бранденбургских ворот

  • atom:author

    Cодержит информацию о владельце фотографии. На данный момент информация ограничивается логином пользователя на Яндексе, который указывается во вложенном теге atom:name: alekna

  • atom:link [@rel="self"]

    Ссылка на ресурс фотографии: <link href="http://api-fotki.yandex.ru/api/users/maxum/photo/126746/" rel="self" />

    Данная ссылка может, например, понадобиться для обращения к ресурсу, если его описание было получено в составе коллекции.

    XPath-выражение для получения цели (URL) ссылки: atom:link[@rel=self]/@href

  • atom:link [@rel="edit"]

    Ссылка для редактирования ресурса фотографии: <link href="http://api-fotki.yandex.ru/api/users/alekna/photo/126746/" rel="edit" />

    XPath-выражение для получения цели (URL) ссылки: atom:link[@rel=edit]/@href

  • atom:link [@rel="alternate"]

    Ссылка на web-страницу фотографии в интерфейсе Яндекс.Фоток: <link href="http://fotki.yandex.ru/users/alekna/view/126746/" rel="alternate" />

    XPath-выражение для получения цели (URL) ссылки: atom:link[@rel=alternate]/@href

  • atom:link [@rel="edit-media"]

    Ссылка для редактирования содержания ресурса фотографии (графического файла): <link href="http://img-fotki.yandex.ru/get/3306/alekna.0/0_1ef1a_9a6e7171_XL" rel="edit-media" />

    Для каждой фотографии создается несколько графических файлов разного размера. Для доступа к фотографии в другом размере нужно изменить суффикс в вышеприведенном URL (см. Хранение графического файла фотографии).

    XPath-выражение для получения цели (URL) ссылки: atom:link[@rel=edit-media]/@href

  • atom:link [@rel="album"]

    Ссылка на альбом, в котором содержится фотография: <link href="http://api-fotki.yandex.ru/api/users/alekna/album/63988/" rel="album" />

    XPath-выражение для получения цели (URL) ссылки: atom:link[@rel=album]/@href

  • app:edited

    Время последнего редактирования фотографии: <app:edited>2009-01-27T11:57:32Z</app:edited>

    Формат времени соответствует RFC3339.

  • atom:updated

    Время последнего значимого с точки зрения системы изменения альбома (в текущей версии API Фоток любое изменение считается значимым, вследствие чего значение atom:updated совпадает с app:edited: 2009-01-27T11:57:32Z).

    Формат времени соответствует RFC3339.

  • atom:published

    Время загрузки фотографии: 2009-01-27T11:57:32Z

    Формат времени соответствует RFC3339.

  • f:created

    Дата создания фотографии согласно ее EXIF-данным: 2008-07-10T22:02:40

    Формат времени соответствует RFC3339 без указания часового пояса.

  • f:access

    Уровень доступа к фотографии: <f:access value="private" />

  • f:xxx

    Флаг доступности фотографии только взрослой аудитории: <f:xxx value="false" />

    Данный параметр может быть установлен только один раз: после того, как фото было помечено "только для взрослых", сбросить данную установку будет невозможно.

  • f:hide_original

    Флаг, запрещающий показ оригинала фотографии: <f:hide_original value="false" />

  • f:disable_comments

    Флаг, запрещающий комментирование фотографии: <f:disable_comments value="false" />

  • atom:content

    Ссылка на графический файл фотографии: <content src="http://img-fotki.yandex.ru/get/3306/maxum.0/0_1ef1a_9a6e7171_XL" type="image/*" />

    Для каждой фотографии создается несколько графических файлов разного размера. Для доступа к фотографии в другом размере, нужно изменить суффикс в вышеприведенном URL (см. Хранение графического файла фотографии).

    XPath-выражение для получения цели (URL) ссылки: atom:content/@src

См. также