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

В настоящее время наш API позволяет загружать изображения только в качестве гостя. Скоро будет доступна новая версия API, в которой будет реализовано кроме стандартной функции upload, еще и загрузка upload под определенным пользователем с паролем и функции работы с картинками и альбомами: изменение информации о картинке, создание альбома, удаление альбома, изменение альбома, перенос в другой альбом, удаление картинки. (данный функционал уже тестируется в бета режиме по запросу можем предоставить новые функции API)


API вызовы

API работает с POST и GET запросами, но предпочтительным методом является POST.


URL-адрес запроса

https://photosp.ru/api/1/(action)/ (если это не сработает, попробуйте удалить слеш '/' в конце)


Параметры

key - ключ* (получить его можно по запросу здесь).

action - то что вы хотите сделать, значение по умолчанию: [values: upload].

source - источник картинки: может быть base64 кодом картинки, файлом или URL.

format - формат ответа: json (используется по умолчанию), redirect, txt.


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

GET https://photosp.ru/api/1/upload/?key=c6133147592983996b65dda51ba70255&source=http://somewebsite/someimage.jpg&format=json


Ответ API

Ответы будут варьироваться в зависимости от формата параметра:

json - будет отображать все изображения и подробные данные в формате json. [по умолчанию]

txt - возвращает изображение прямой URL на текст/обычный формат.

redirect - перенаправляет на URL-адрес изображения посетителя.

При использовании json ответ будет иметь заголовки коды статуса, чтобы позволить вам легко понять, запрос был корректный или нет.

status_code и status_txt


Пример ответа (JSON)

{ "status_code": 200, "success": { "message": "image uploaded", "code": 200 }, "image": { "name": "example", "extension": "png", "size": 53237, "width": 1151, "height": 898, "date": "2014-06-04 15:32:33", "date_gmt": "2014-06-04 19:32:33", "storage_id": null, "description": null, "nsfw": "0", "md5": "c684350d722c956c362ab70299735830", "storage": "datefolder", "original_filename": "example.png", "original_exifdata": null, "views": "0", "id_encoded": "L", "filename": "example.png", "ratio": 1.2817371937639, "size_formatted": "52 KB", "mime": "image/png", "bits": 8, "channels": null, "url": "https://photosp.ru/images/2014/06/04/example.png", "url_viewer": "https://photosp.ru/image/L", "thumb": { "filename": "example.th.png", "name": "example.th", "width": 160, "height": 160, "ratio": 1, "size": 17848, "size_formatted": "17.4 KB", "mime": "image/png", "extension": "png", "bits": 8, "channels": null, "url": "https://photosp.ru/images/2014/06/04/example.th.png" }, "medium": { "filename": "example.md.png", "name": "example.md", "width": 500, "height": 390, "ratio": 1.2820512820513, "size": 104448, "size_formatted": "102 KB", "mime": "image/png", "extension": "png", "bits": 8, "channels": null, "url": "https://photosp.ru/images/2014/06/04/example.md.png" }, "views_label": "views", "display_url": "https://photosp.ru/images/2014/06/04/example.md.png", "how_long_ago": "moments ago" }, "status_txt": "OK" }

Пример ответа (TXT)

https://photosp.ru/images/2014/06/04/example.png

Нажмите на миниатюру, чтобы отредактировать изображение или изменить его размер
Отредактируйте изображение касанием окна предпросмотра.
Вы можете добавить изображения с вашего компьютера или добавить ссылки на изображения.
Загружается 0 изображение (0% завершено)
Загружается очередь изображений. Это может занять некоторое время.
Загрузка завершена
Загруженное содержимое добавлено к . Вы можете создать новый альбом с загруженным содержимым.
Загруженное содержимое добавлено к .
Вы можете создать аккаунт и войти, чтобы сохранить содержимое в своем аккаунте.
Не было загружено ни одного изображение.
В процессе обработки вашего запроса произошла ошибка.
    Внимание: Некоторые изображения не были загружены. подробнее
    Проверьте отчет об ошибках для получения более подробной информации.
    JPG PNG GIF 10 MB