API

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"
}

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

http://127.0.0.1/images/2014/06/04/example.png

Последнее обновление: 14 июля 2023 г.


JPG JPEG PNG BMP GIF WEBP 3 MB

Customize upload by clicking on any preview
Customize upload by touching on any preview
Uploading 0 files (0% completo)
The queue is being uploaded, it should take just a few seconds to complete.
Envio completo
Uploaded content added to . You can create new álbum with the content just uploaded.
Uploaded content added to .
You can create new álbum with the content just uploaded. You must create an account or sign in to save this content into your account.
No file have been uploaded
Some errors have occurred and the system couldn't process your request.
    Sign up to be able to customize or disable image auto delete.
    Note: Some files couldn't be uploaded. Saber mais
    Verifique o relatório de erro para mais informações.