Ресурсы

Фотографии, альбомы и теги являются ресурсами.

API Фоток придерживается следующих правил:

• каждый ресурс имеет уникальный адрес (URL), к которому можно обращаться определённым набором HTTP-методов (см. Схема адресов);
• ресурсы связаны между собой ссылками;
• клиентское приложение и сервис API обмениваются представлениями ресурсов в виде Atom Entry или Atom Feed. Кроме XML-формата Atom поддерживается переложение Atom на JSON.

Фотографии, альбомы и теги представляются Entry-элементами.

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

Коллекции представляются Feed-элементами.

Все ресурсы связаны между собой ссылками. Адрес каждого ресурса следует определять из представления ресурса, который на него ссылается. Например, из альбома можно получить ссылку на коллекцию его фотографий, а из коллекции фотографий можно получить ссылки на отдельные фотографии этого альбома.

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

Для получения списка HTTP-методов, поддерживаемых ресурсом, следует обратиться по адресу ресурса с помощью метода OPTIONS. Список доступных методов может изменяться в зависимости от авторизации (см. Использование токена).

OPTIONS http://api-fotki.yandex.ru/api/users/alekna/photos/ HTTP/1.1
Host: api-fotki.yandex.ru
Authorization: OAuth eb1c5...

HTTP/1.1 204 NO CONTENT
Content-Type: text/plain; charset=utf-8
Content-Length: 0
Allow: OPTIONS, POST, HEAD, GET