API Яндекс.Фоток. Руководство разработчика: Загрузка изображения в альбом

Для загрузки изображения в альбом на сервер передается файл изображения по адресу коллекции фотографий этого альбома.

На предыдущем этапе был создан альбом «Путешествия» с идентификатором urn:yandex:fotki:alekna:album:168628. Из Atom Entry альбома был извлечен элемент <link href="..." rel="photos" />, содержащий адрес коллекции фотографий этого альбома (см. Создание нового альбома).

Загружаем изображение в альбом «Путешествия»:

POST http://api-fotki.yandex.ru/api/users/alekna/album/168628/photos/ HTTP/1.1
Host: api-fotki.yandex.ru
Content-Type: image/jpeg
Content-Length: 153123
Authorization: OAuth eb1c5...
 
{содержимое файла изображения в бинарном виде}

Сервер возвращает код состояния «201 Created» и представление фотографии:

HTTP/1.1 201 CREATED
Content-Type: application/atom+xml; type=entry
Location: http://api-fotki.yandex.ru/api/users/alekna/photo/448328/
Content-Location: http://fotki.yandex.ru/users/alekna/view/448328/

<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:448328</id>
  <author>
    <name>alekna</name>
  </author>
  <title>Фотка</title>
  <link href="http://api-fotki.yandex.ru/api/users/alekna/photo/448328/" rel="self" />
  <link href="http://api-fotki.yandex.ru/api/users/alekna/photo/448328/" rel="edit" />
  <link href="http://fotki.yandex.ru/users/alekna/view/448328/" rel="alternate" />
  <link href="http://img-fotki.yandex.ru/get/5302/alekna.1/0_6d748_e3942262_orig" rel="edit-media" />
  <link href="http://api-fotki.yandex.ru/api/users/alekna/album/168628/" rel="album" />
  <published>2011-05-10T10:24:44Z</published>
  <app:edited>2011-05-10T10:24:44Z</app:edited>
  <updated>2011-05-10T10:24:44Z</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/5302/alekna.1/0_6d748_e3942262_XXS" size="XXS" width="75" />
  <f:img height="453" href="http://img-fotki.yandex.ru/get/5302/alekna.1/0_6d748_e3942262_XL" size="XL" width="604" />
  <f:img height="225" href="http://img-fotki.yandex.ru/get/5302/alekna.1/0_6d748_e3942262_M" size="M" width="300" />
  <f:img height="375" href="http://img-fotki.yandex.ru/get/5302/alekna.1/0_6d748_e3942262_L" size="L" width="500" />
  <f:img height="50" href="http://img-fotki.yandex.ru/get/5302/alekna.1/0_6d748_e3942262_XXXS" size="XXXS" width="50" />
  <f:img height="113" href="http://img-fotki.yandex.ru/get/5302/alekna.1/0_6d748_e3942262_S" size="S" width="150" />
  <f:img height="75" href="http://img-fotki.yandex.ru/get/5302/alekna.1/0_6d748_e3942262_XS" size="XS" width="100" />
  <f:img height="453" href="http://img-fotki.yandex.ru/get/5302/alekna.1/0_6d748_e3942262_orig" size="orig" width="604" />
  <content src="http://img-fotki.yandex.ru/get/5302/alekna.1/0_6d748_e3942262_orig" type="image/*" />
</entry>

Созданной фотографии присвоен глобальный идентификатор urn:yandex:fotki:alekna:photo:448328. Адрес ресурса фотографии указывается в ответе сервера в заголовке Location и в теле ответа в атрибуте href элемента <link href="..." rel="self" />. В дальнейшем по этому адресу можно получить представление этой фотографии.

При загрузке изображения не были указаны его свойства, поэтому по умолчанию фотография создалась с названием «Фотка», и ей были установлены права доступа private («для себя»). Чтобы изменить свойства фотографии и предоставить к ней доступ всем, фотографию нужно отредактировать (см. Редактирование фотографии).

Адрес ресурса, к которому нужно обратиться, чтобы отредактировать фотографию, содержится в атрибуте href элемента <link href="..." rel="edit" />:

http://api-fotki.yandex.ru/api/users/alekna/photo/448328/.

Далее - Редактирование фотографии.

Был показан лишь один из методов загрузки изображений. Описание всех методов приведено в разделе Загрузка изображения.

API Фоток:

Загрузка изображения в альбом