API RadikalFoto.host позволяет загружать изображения.
API-ключ
Можно получить в разделе "Настройки" аккаунта > вкладка "API"
https://radikalfoto.host/settings/api
Метод запроса
Вызовы API можно выполнять с помощью методов запроса POST или GET.
URL-адрес запроса
Авторизация
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"
}
Пример ответа (txt)
http://127.0.0.1/images/2014/06/04/example.png
Последнее обновление: 14 июля 2023 г.