Общие сведения

API Яндекс.Фоток предоставляет интерфейс для взаимодействия с сервисом Яндекс.Фотки.

Работа с API осуществляется в соответствии с принципами REST, посредством HTTP-запросов с использованием методов GET, POST, PUT и DELETE.

API позволяет оперировать ресурсами: фотографиями, альбомами, тегами и и их коллекциями. Каждая фотография представлена в виде набора изображений (бинарных файлов) и сопутствующих данных (название, описание и пр.). Фотографии размещаются в альбомах, у которых также имеются собственные название, описание и прочие свойства.

У каждого ресурса имеется собственный адрес (URL).

В API Фоток для работы с ресурсами используется протокол AtomPub (Atom Publishing Protocol). HTTP-методы используются для выполнения определённых действий:

• GET — получение ресурса;
• POST — создание ресурса;
• PUT — изменение ресурса;
• DELETE — удаление ресурса.

Список ресурсов и доступных для них операций приведён в справочнике ресурсов.

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