Micro Pictures

API Документация

Общие сведения

Все ответы от сервера приходят в формате JSON. В каждом ответе содержится статус запроса (поле ‘status’), если действие выполнено успешно, то это поле принимает значение ‘success’, если ошибка - ‘failed’, помимо этого при возникновении ошибки появляется поле ‘message’, которое содержит в себе описание ошибки(кодированное через функцию escape()).

Пример ответа: {"status":"failed","message":"\u0418\u0437\u043e\u0431\u0440\u0430\u0436\u0435\u043d\u0438\u0435 \u043d\u0435 \u043d\u0430\u0439\u0434\u0435\u043d\u043e!"}

Загрузка файлов

Есть два способа загрузки изображения:

  • Через URL (адрес запроса - http://micropic.ru/api/upload/link)
  • Зарузка файла (адрес запроса - http://micropic.ru/api/upload/file)

В обоих случаях нужно посылать POST запрос на нужный адрес, с файлом изображения или его URL в поле ‘upload’.

Пример ответа: {"status":"success","image":{"img":"http:\/\/s3.micp.ru\/thumb\/u2nl7.png","full":"http:\/\/s3.micp.ru\/u2nl7.png","id":"u2nl7"}}

Получение данных о изображении

Для получения дополнительных данных о изображении(таких как дата загрузки, размеры и т.д.) нужно отправить следующий запрос на сервер: http://micropic.ru/api/view/{id картинки}

Пример ответа: {"status":"success","image":{"id":"rA3pL","full_adress":"http:\/\/s2.micp.ru\/rA3pL.png","thumb_adress":"http:\/\/s2.micp.ru\/thumb\/rA3pL.png","width":"200","height":"200","size":"4","dtime":"2012-07-24 09:42:34","camera":"No","takedate":"No","exposure":"No","aperture":"No"}}

Данные из ответа:

  • id - идентификационный номер картинки
  • full_adress - адрес полного изображения
  • thumb_adress - адрес превью
  • width/height - ширина и высота в пикселях
  • size - размер изображения в килобайтах
  • dtime - дата и время загрузки изображения на сервер
  • camera - камера, на которую снято фото(если нет данных, принимает значение ‘No’)
  • takedate - дата съемки фото(если данных нет, отдает значение ‘No’)
  • exposure - экспозиция (отдает ‘No’, если данных нет)
  • aperture - диафрагма(аналогично с ‘exposure’, отдает ‘No’ при отсутствии данных)

Действия с изображениями

Для создания короткой ссылки на изображение или его удаления, нужно послать соответствующий GET запрос на сервер:

  • для удаления - http://micropic.ru/api/delete/{id картинки}
  • для создания короткой ссылки - http://micropic.ru/api/short/{id картинки}

В ответ вы получите сообщение о том, что операция успешно завершена или ошибку(с подробным описанием).

Пример правильного ответа (создание короткой ссылки): {"status":"success","message":"http:\/\/goo.gl\/lBBzc"} Удаление изображения: {"status":"success"}

Изображения пользователя

Для получения всех изображений загруженных пользователем(с его ip адреса) существует метод ‘myimages’ в API.

Адрес для запроса - http://micropic.ru/api/myimages

Ответ будет содержать в себе массив с данными о последних 2000(т.е. максимальное кол-во записей в ответе равняется 2-м тысячам) изображениях пользователя.

Пример ответа: {"status":"success","images":[{"id":"u2nl7","thumb_adress":"http:\/\/s3.micp.ru\/thumb\/u2nl7.png","full_adress":"http:\/\/s3.micp.ru\/u2nl7.png"},{"id":"4lJP8","thumb_adress":"http:\/\/s3.micp.ru\/thumb\/4lJP8.jpg","full_adress":"http:\/\/s3.micp.ru\/4lJP8.jpg"},{"id":"I6Q53","thumb_adress":"http:\/\/s2.micp.ru\/thumb\/I6Q53.jpg","full_adress":"http:\/\/s2.micp.ru\/I6Q53.jpg"},{"id":"rE7pl","thumb_adress":"http:\/\/s2.micp.ru\/thumb\/rE7pl.jpg","full_adress":"http:\/\/s2.micp.ru\/rE7pl.jpg"},{"id":"7lp2U","thumb_adress":"http:\/\/s3.micp.ru\/thumb\/7lp2U.png","full_adress":"http:\/\/s3.micp.ru\/7lp2U.png"}]}