Авторизация
Требуется. Данную операцию может выполнить только владелец коллекции фотографий.
Способы загрузки изображения
Описание загрузки изображения см. в разделе Загрузка изображения.
При выполнении POST-запроса по адресу коллекции фотографий альбома изображение добавляется в соответствующий альбом.
Поле album можно не указывать. Если оно указывается, то его значение должно соответствовать альбому, по адресу которого выполняется запрос.
Пример
Загрузка изображения POST-запросом в формате multipart/form-data:
POST http://api-fotki.yandex.ru/api/users/alekna/album/169752/photos/ HTTP/1.1
Host: api-fotki.yandex.ru
Content-Length: 1760
Content-Type: multipart/form-data; boundary=frekgh738gGHUehfui33qqQ
Authorization: OAuth eb1c5...
--frekgh738gGHUehfui33qqQ
Content-Disposition: form-data; name="image"; filename="lake.jpg"
Content-Type: image/jpeg
{содержимое файла "lake.jpg" в бинарном виде}
--frekgh738gGHUehfui33qqQ
Content-Disposition: form-data; name="title"
Байкал
--frekgh738gGHUehfui33qqQ
Content-Disposition: form-data; name="description"
Мои любимые места
--frekgh738gGHUehfui33qqQ
Content-Disposition: form-data; name="album"
urn:yandex:fotki:alekna:album:169752
--frekgh738gGHUehfui33qqQ
Content-Disposition: form-data; name="tags"
природа
В случае успешной загрузки сервер возвращает 201 Created и Atom Entry фотографии:
HTTP/1.1 201 CREATED
Content-Type: application/atom+xml; type=entry
Locaion: http://api-fotki.yandex.ru/api/users/alekna/photo/455105/
Content-Location: http://fotki.yandex.ru/users/alekna/view/455105/
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:app="http://www.w3.org/2007/app" xmlns:f="yandex:fotki">
<id>urn:yandex:fotki:alekna:photo:455105</id>
<author>
<name>alekna</name>
</author>
<title>Байкал</title>
<link href="http://api-fotki.yandex.ru/api/users/alekna/photo/455105/" rel="self" />
<link href="http://api-fotki.yandex.ru/api/users/alekna/photo/455105/" rel="edit" />
<link href="http://fotki.yandex.ru/users/alekna/view/455105/" rel="alternate" />
<link href="http://img-fotki.yandex.ru/get/5009/alekna.2/0_6f1c1_cadfa847_orig" rel="edit-media" />
<link href="http://api-fotki.yandex.ru/api/users/alekna/album/169752/" rel="album" />
<published>2011-05-27T12:05:01Z</published>
<app:edited>2011-05-27T12:05:01Z</app:edited>
<updated>2011-05-27T12:05:01Z</updated>
<f:access value="private" />
<f:xxx value="false" />
<f:hide_original value="false" />
<f:disable_comments value="false" />
<f:img height="75" href="http://img-fotki.yandex.ru/get/5009/alekna.2/0_6f1c1_cadfa847_XXS" size="XXS" width="75" />
<f:img height="453" href="http://img-fotki.yandex.ru/get/5009/alekna.2/0_6f1c1_cadfa847_XL" size="XL" width="604" />
<f:img height="225" href="http://img-fotki.yandex.ru/get/5009/alekna.2/0_6f1c1_cadfa847_M" size="M" width="300" />
<f:img height="375" href="http://img-fotki.yandex.ru/get/5009/alekna.2/0_6f1c1_cadfa847_L" size="L" width="500" />
<f:img height="50" href="http://img-fotki.yandex.ru/get/5009/alekna.2/0_6f1c1_cadfa847_XXXS" size="XXXS" width="50" />
<f:img height="113" href="http://img-fotki.yandex.ru/get/5009/alekna.2/0_6f1c1_cadfa847_S" size="S" width="150" />
<f:img height="75" href="http://img-fotki.yandex.ru/get/5009/alekna.2/0_6f1c1_cadfa847_XS" size="XS" width="100" />
<f:img height="453" href="http://img-fotki.yandex.ru/get/5009/alekna.2/0_6f1c1_cadfa847_orig" size="orig" width="604" />
<category scheme="http://api-fotki.yandex.ru/api/users/alekna/tags/" term="природа" />
<content src="http://img-fotki.yandex.ru/get/5009/alekna.2/0_6f1c1_cadfa847_orig" type="image/*" />
</entry>
Пример
Добавление изображения простым POST-запросом в коллекцию фотографий альбома пользователя alekna:
POST http://api-fotki.yandex.ru/api/users/alekna/album/166472/photos/ HTTP/1.1
Host: api-fotki.yandex.ru
Content-Type: image/jpeg
Content-Length: 237532
Authorization: OAuth eb1c5...
{содержимое файла "Байкал.jpg" в бинарном виде}
В случае успешной загрузки сервер возвращает 201 Created и Atom Entry фотографии.
Чтобы указать свойства фотографии (название, описание, права доступа) или переместить ее в какой-либо альбом, необходимо отредактировать фотографию после загрузки (см.
Редактирование фотографии).
Возможные ошибки
См. в разделе Загрузка изображения.
