API

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

API-ключ

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

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

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

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

https://imgfoto.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://imgfoto.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 5 MB
Кликните на изображение для редактирования
Кликните на изображение для редактирования
Загружается 0 files (0% завершено)
Загружается очередь изображений. Это может занять некоторое время.
Загрузка завершена
Загруженное содержимое добавлено к альбому . Вы можете создать новый альбом с загруженным содержимым.
Загруженное содержимое добавлено к альбому .
Вы можете создать новый альбом с загруженным содержимым. Вы должны создать аккаунт или войти, чтобы сохранить это содержимое в свой аккаунт.
Не было загружено ни одного файл.
Some errors have occurred and the system couldn't process your request.
    Зарегистрируйтесь, чтобы получить дополнительные возможности или отключить автоматическое удаление изображений.
    Note: Some files couldn't be uploaded. подробнее
    Проверьте отчет об ошибках для получения более подробной информации.