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

API фоток поддерживает два формата: Atom Syndication Format (сокращенно Atom) и Atom-подобный JSON.

Для указания формата, в котором должно быть возвращено представление ресурса, используется заголовок Accept или query-параметра format.

Формат	Значение заголовка Accept	Значение параметра format
Atom	application/atom+xml	atom
JSON	application/json	json

Если в запросе используется и заголовок Accept и параметр format, то приоритет имеет параметр format. Если не указано ни то, ни другое, выдача производится в формате Atom.

Пример

Запрос сервисного документа в формате JSON с помощью заголовка Accept:

GET /api/users/alekna/ HTTP/1.1
Host: api-fotki.yandex.ru
Accept: application/json

или с помощью query-параметра format:

GET /api/users/alekna/?format=json HTTP/1.1
Host: api-fotki.yandex.ru

При использовании методов POST и PUT формат данных задаётся с помощью заголовка Content-Type:

Формат	Тип ресурса	Значение заголовка Content-Type
Atom	Сервисный документ	application/atomsvc+xml
	Фотография, альбом, тег	application/atom+xml; type=entry
	Коллекция	application/atom+xml; type=feed
JSON	Для всех ресурсов	application/json

Пример

Добавление фотографии в формате Atom:

POST /api/users/alekna/album/12345/ HTTP/1.1
Host: api-fotki.yandex.ru
Content-Type: application/atom+xml;  type=entry

{Atom Entry фотографии}

Добавление фотографии в формате JSON:

POST /api/users/alekna/album/12345/ HTTP/1.1
Host: api-fotki.yandex.ru
Content-Type: application/json

{JSON-представление фотографии}

API Фоток:

Форматы обмена данными

Пример

Пример