Авторизация
Требуется. Данную операцию может выполнить только владелец коллекции фотографий.
Способы загрузки изображения
Общее описание загрузки изображения см. в разделе Загрузка изображения.
При выполнении POST-запроса по адресу общей коллекции фотографий картинка добавляется в альбом по умолчанию.
Изображение можно добавить и в определенный альбом. Для этого в поле запроса album указывается идентификатор Atom Entry нужного альбома.
Пример
Загрузка изображения POST-запросом в формате multipart/form-data:
POST http://api-fotki.yandex.ru/api/users/alekna/photos/ HTTP/1.1
Host: api-fotki.yandex.ru
Content-Length: 237532
Content-Type: multipart/form-data; boundary=frekgh738gGHUehfui33qqQ
Authorization: OAuth eb1c5..
--frekgh738gGHUehfui33qqQ
Content-Disposition: form-data; name="image"; filename="Байкал.jpg"
Content-Type: image/jpeg
{содержимое файла Байкал.jpg в бинарном виде}
--frekgh738gGHUehfui33qqQ
Content-Disposition: form-data; name="title"
Байкал
--frekgh738gGHUehfui33qqQ
Content-Disposition: form-data; name="description"
Байкал на закате
--frekgh738gGHUehfui33qqQ
Content-Disposition: form-data; name="tags"
природа, закаты
В случае успешной загрузки сервер возвращает 201 Created и Atom Entry фотографии:
HTTP/1.1 201 CREATED
Content-Type: application/atom+xml; type=entry
Location: http://api-fotki.yandex.ru/api/users/alekna/photo/455106/
Content-Location: http://fotki.yandex.ru/users/alekna/view/455106/
<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:455106</id>
<author>
<name>alekna</name>
</author>
<title>Байкал</title>
<link href="http://api-fotki.yandex.ru/api/users/alekna/photo/455106/" rel="self" />
<link href="http://api-fotki.yandex.ru/api/users/alekna/photo/455106/" rel="edit" />
<link href="http://fotki.yandex.ru/users/alekna/view/455106/" rel="alternate" />
<link href="http://img-fotki.yandex.ru/get/5706/alekna.2/0_6f1c2_7eff8311_orig" rel="edit-media" />
<link href="http://api-fotki.yandex.ru/api/users/alekna/album/169753/" rel="album" />
<published>2011-05-27T12:10:30Z</published>
<app:edited>2011-05-27T12:10:30Z</app:edited>
<updated>2011-05-27T12:10:30Z</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/5706/alekna.2/0_6f1c2_7eff8311_XXS" size="XXS" width="75" />
<f:img height="453" href="http://img-fotki.yandex.ru/get/5706/alekna.2/0_6f1c2_7eff8311_XL" size="XL" width="604" />
<f:img height="225" href="http://img-fotki.yandex.ru/get/5706/alekna.2/0_6f1c2_7eff8311_M" size="M" width="300" />
<f:img height="375" href="http://img-fotki.yandex.ru/get/5706/alekna.2/0_6f1c2_7eff8311_L" size="L" width="500" />
<f:img height="50" href="http://img-fotki.yandex.ru/get/5706/alekna.2/0_6f1c2_7eff8311_XXXS" size="XXXS" width="50" />
<f:img height="113" href="http://img-fotki.yandex.ru/get/5706/alekna.2/0_6f1c2_7eff8311_S" size="S" width="150" />
<f:img height="75" href="http://img-fotki.yandex.ru/get/5706/alekna.2/0_6f1c2_7eff8311_XS" size="XS" width="100" />
<f:img height="453" href="http://img-fotki.yandex.ru/get/5706/alekna.2/0_6f1c2_7eff8311_orig" size="orig" width="604" />
<category scheme="http://api-fotki.yandex.ru/api/users/alekna/tags/" term="закаты" />
<category scheme="http://api-fotki.yandex.ru/api/users/alekna/tags/" term="природа" />
<content src="http://img-fotki.yandex.ru/get/5706/alekna.2/0_6f1c2_7eff8311_orig" type="image/*" />
</entry>
Пример
Добавление изображения простым POST-запросом в коллекцию фотографий пользователя alekna:
POST http://api-fotki.yandex.ru/api/users/alekna/photos/ HTTP/1.1
Host: api-fotki.yandex.ru
Content-Type: image/jpeg
Content-Length: 237532
Authorization: OAuth eb1c5..
{содержимое файла "Байкал.jpg" в бинарном виде}
В случае успешной загрузки сервер возвращает 201 Created и Atom Entry фотографии.
Изображение добавляется в альбом по умолчанию. Чтобы переместить картинку в какой-либо альбом или указать ее свойства (название, описание, права доступа), необходимо после загрузки ее отредактировать (см.
Редактирование фотографии).
Возможные ошибки
См. в разделе Загрузка изображения.
