ImageBan.ru - API сервиса ImageBan.ru

Сервис 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