photos.upload rest api

Загружает фотографию в альбом.Загружает фотографию в альбом.

Для вызова функции требуется привилегия photos. Вы можете загрузить фотографию без запроса привилегий с помощью функции photos.uploadjs.

Параметры

Имя Тип Описание
aidstringидентификатор альбома, в который производится загрузка; обязательный параметр
img_urlstringссылка на картинку в интернете
img_filefileфайл для загрузки; обратите внимание, параметр не участвует в формировании подписи запроса; игнорируется, если указан img_url
namestringназвание фотографии
descriptionstringописание фотографии
themeintидентификатор тематики картинки (см. ниже); по-умолчанию 5

Возможные варианты значений параметра theme:

Результат

Возвращает объект созданной фотографии в формате, аналогичном photos.getrest.

Коды ошибок

КодОписание
1Unknown error: Please resubmit the request.
2Unknown method called.
3Service Unavailable. Please try again later.
4Method is deprecated.
100One of the parameters specified is missing or invalid.
102User authorization failed: the session key or uid is incorrect.
103Application lookup failed: the application id is not correct.
104Incorrect signature.
105Application is not installed for this user.
200Permission error: the application does not have permission to perform this action.
501Image is incorrect or inaccessible

Пример вызова

http://www.appsmail.ru/platform/api?method=photos.upload&
app_id=123456&session_key=551fd0e4779e35859dfccd03397dc8a0&
sig=95a393ed7639184a52f7a17b6771a92&img_url=http://server/file.jpg&
name=my_photo&theme=17

См. также

Использование REST API

Функции REST API