Upload image and get a link (URL).

API RadikalFoto.host позволяет загружать изображения.

API-ключ

Можно получить в разделе "Настройки" аккаунта > вкладка "API"
https://radikalfoto.host/settings/api

Метод запроса

Вызовы API можно выполнять с помощью методов запроса POST или GET.

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

https://radikalfoto.host/api/1/upload

Авторизация

API поддерживает авторизацию заголовка путем передачи X-API-Key заголовка с ключом API.
X-API-Key: chv_asd_somekeyhere

Требуемые параметры

Имя	Описание
source	URL-адрес изображения или base64 (opens new window) кодированная строка изображения. Также поддерживаются файлы ["source"].

Дополнительные параметры

Имя	Описание
title	Заголовок изображения
description	Описание изображения
album_id	Идентификатор альбома изображений, должен принадлежать пользователю (кодированная строка)
category_id	Идентификатор категории (целое число)
width	Целевой размер по ширине (автоматическая высота)
expiration	Истечение времени для автоматического удаления изображения
nsfw	Флаг небезопасен для работы (целое число 0, 1)
format	Возвращаемый формат, значения `json`, `redirect`, `txt`

Таблица сроков действия

Для параметра можно использовать следующие значения expiration.

Значение	Истекает через
PT5M	5 minutes
PT15M	15 minutes
PT30M	30 minutes
PT1H	1 hour
PT3H	3 hours
PT6H	6 hours
PT12H	12 hours
P1D	1 day
P2D	2 days
P3D	3 days
P4D	4 days
P5D	5 days
P6D	6 days
P1W	1 week
P2W	2 weeks
P3W	3 weeks
P1M	1 month
P2M	2 months
P3M	3 months
P4M	4 months
P5M	5 months
P6M	6 months
P1Y	1 year

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

POST https://radikalfoto.host/api/1/upload/

Ответ API

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

Формат	Выход
json	Информация о загрузке изображения в формате JSON (по умолчанию)
txt	Прямой URL-адрес изображения в текстовом / обычном формате
redirect	Перенаправляет на URL-адрес программы просмотра изображений

При использовании JSON вывод ответа будет содержать свойства status_txt и status_code.

Пример ответа (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": "http://127.0.0.1/images/2014/06/04/example.png",
        "url_viewer": "http://127.0.0.1/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": "http://127.0.0.1/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": "http://127.0.0.1/images/2014/06/04/example.md.png"
        },
        "views_label": "views",
        "display_url": "http://127.0.0.1/images/2014/06/04/example.md.png",
        "how_long_ago": "moments ago"
    },
    "status_txt": "OK"
}