Надёжный хостинг картинок

Бесплатный хостинг изображений

Сервис Image


Получение информации об изображении.


GET https://api.imageban.ru/v1/image/info/{ID}

Описание: Получаем информацию об изображении. (в {ID} указывается id изображения, пример: JTXBeN4).

Заголовок
Authorization Bearer {SECRET_KEY}

Пример:
curl --location -g 'https://api.imageban.ru/v1/image/info/JTXBeN4' \
--header 'Authorization: Bearer {SECRET_KEY}'
Ответ:
{
    "data": [
        {
            "id": "JTXBeN4",
            "date": "2022.07.13",
            "name": "8b2313babd49d05ff36b8165845fc615.jpeg",
            "album": null,
            "server": "i5.imageban.ru",
            "views": "120",
            "description": "",
            "img_name": "luca.jpeg",
            "favorite": false,
            "size": "355593",
            "resolution": "2000x3234",
            "link": "https://i5.imageban.ru/out/2022/07/13/8b2313babd49d05ff36b8165845fc615.jpeg",
            "short_link": "http://ibn.im/i/JTXBeN4"
        }
    ],
    "success": true,
    "status": 200
}
                    

Возвращаемые данные:

Ключ Формат Описание
id string id изображения
date string Дата загрузки
name string Имя загруженного файла на сервер
album mixed ID альбома, где находится изображение. Если изображение не в альбоме возвращает null
server string Имя сервера где расположено загруженное изображение
views integer Количество просмотров изображения
description string Описание к изображению (комментарий)
img_name string Оригинальное имя файла
favorite boolean Указывает добавлено ли изображение в избранное
size integer Размер изображения в байтах
resolution string Разрешение изображения
link string Прямая ссылка на изображение
short_link string Короткая ссылка на страницу с изображением

Коды ошибок:

Код Текст ошибки Описание
400 Image does not exist Изображение не существует
403 Invalid secret key Неверный Secret key




Удаление изображений загруженных без авторизации.


DELETE https://api.imageban.ru/v1/image/delete/{DELETE_HASH}

Описание: Удаление изображений загруженных только неавторизованными пользователями (в delete_hash указывается хэш из ссылки удаления изображения).

Заголовок:
Authorization TOKEN {CLIENT_ID}

Пример:
curl --location -g --request DELETE 'https://api.imageban.ru/v1/image/delete/oYTXkNjyEubv1lVbNDpRwv9aXLaPB3oT' \
--header 'Authorization: TOKEN {CLIENT_ID}'
Ответ:
{
    "data": true,
    "success": true,
    "status": 200
}   

Коды ошибок:

Код Текст ошибки Описание
400 Image deletion error Отсутвует изображение для удаления
401 Invalid image hash Неверный хэш для удаления
402 Invalid client key Неверный CLIENT_KEY
403 Invalid secret key Неверный SECRET_KEY
404 No auth data Нет данных для авторизации


Удаление изображений загруженных авторизованным пользователем.


DELETE https://api.imageban.ru/v1/image/delete/{ID}

Описание: Удаление изображений загруженных только неавторизованными пользователями (в ID указывается id удаляемого изображения, пример: JTXBeN4).

Заголовок:
Authorization: Bearer {SECRET_KEY}

Пример:
curl --location -g --request DELETE 'https://api.imageban.ru/v1/image/delete/JTXBeN4' \
--header 'Authorization: Bearer {SECRET_KEY}'
Ответ:
{
    "data": true,
    "success": true,
    "status": 200
}
                     

Коды ошибок:

Код Текст ошибки Описание
401 Invalid image hash Неверный хэш удаления изображения


Добавление изображений в избранное


POST https://api.imageban.ru/v1/image/{ID}/favorite

Описание: Добавляет изображения в избранное

В параметре {ID} указывается идентификатор изображения

Заголовок:
Authorization Bearer {SECRET_KEY}

Пример:
curl --location --request POST 'https://api.imageban.ru/v1/image/{ID}/favorite' \
--header 'Authorization: Bearer {SECRET_KEY}'
Ответ:
{
    "data": true,
    "success": true,
    "status": 200
}
                    

Коды ошибок:

Код Текст ошибки Описание
400 Image does not exist Изображение не существует
403 Invalid secret key Неверный SECRET_KEY


ImageBan.ru бесплатный сервис для публикации изображений на сайтах и форумах © 2009-2024 ImageBan Network. Связь info@imageban.ru Мы ВКонтакте
Get it on Google Play