В настоящее время наш 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
