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

Сервис Account

Получение информации обо всех своих изображениях не в альбомах.

GET https://api.imageban.ru/v1/image/my/{PAGE}/{PER_PAGE}

Описание: Получаем информацию обо всех своих изображениях находящихся не в альбомах (в {PAGE} указывается номер страницы для пагинации, а в {PER_PAGE} количество элементов на странице). {PER_PAGE} имеет значение по умолчанию 20, максимальное значение 500. Если изображений нет, массив images будет пустой.

Заголовок

Authorization Bearer {SECRET_KEY}

Пример:

curl --location -g 'https://api.imageban.ru/v1/image/my/1' \
--header 'Authorization: Bearer {SECRET_KEY}'

Ответ:

 {
    "images": [
        {
            "id": "thfHdJj",
            "date": "2025.05.23",
            "name": "3adf091e7f2102ac372f1e1e8fb2592b.jpg",
            "server": "i1.imageban.ru",
            "views": "0",
            "description": "",
            "img_name": "IMG_20240522_170717.jpg",
            "favorite": false,
            "size": "284653",
            "resolution": "1282x959",
            "link": "https://i1.imageban.ru/out/2025/05/23/3adf091e7f2102ac372f1e1e8fb2592b.jpg",
            "short_link": "http://ibn.im/i/thfHdJj"
        },
        {
            "id": "zf3JFYp",
            "date": "2025.05.23",
            "name": "4fe2044bffc59d7c2b9300bf617d41e9.jpg",
            "server": "i1.imageban.ru",
            "views": "0",
            "description": "fdsfds",
            "img_name": "IMG_20240522_170717.jpg",
            "favorite": false,
            "size": "284653",
            "resolution": "1282x959",
            "link": "https://i1.imageban.ru/out/2025/05/23/4fe2044bffc59d7c2b9300bf617d41e9.jpg",
            "short_link": "http://ibn.im/i/zf3JFYp"
        }
    ],
    "pagination": {
        "total": "2",
        "total_pages": 1,
        "current_page": 1,
        "per_page": 20
    },
    "success": true,
    "status": 200
}

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

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

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

Ключ	Формат	Описание
total	int	Количество изображений не в альбомах
total_pages	int	Количество страниц при пагинации
current_page	int	Текущая страница
per_page	int	Количество элементов на страницу

Коды ошибок:

Код	Текст ошибки	Описание
403	Invalid secret key	Неверный Secret key

Получение информации обо всех своих альбомах

GET https://api.imageban.ru/v1/album/my/{PAGE}/{PER_PAGE}

Описание: Получаем информацию обо всех своих альбомах (в {PAGE} указывается номер страницы для пагинации, а в {PER_PAGE} количество элементов на странице). {PER_PAGE} имеет значение по умолчанию 20, максимальное значение 500. Если альбомов нет, массив albums будет пустой.

Заголовок

Authorization Bearer {SECRET_KEY}

Пример:

curl --location -g 'https://api.imageban.ru/v1/album/my/1/2' \
--header 'Authorization: Bearer {SECRET_KEY}'

Ответ:

{
    "albums": [
        {
            "id": "u0novao",
            "name": "Album_1",
            "description": "",
            "create_date": "2025.05.30",
            "create_time": "10:02:21",
            "privacy": "secret",
            "image_count": 0,
            "link": "https://imageban.ru/a/u0novao"
        },
        {
            "id": "x0sV5OZ",
            "name": "Album_2",
            "description": "",
            "create_date": "2025.05.28",
            "create_time": "14:36:23",
            "privacy": "public",
            "image_count": 0,
            "link": "https://imageban.ru/a/x0sV5OZ"
        }
    ],
    "pagination": {
        "total": 89,
        "total_pages": 45,
        "current_page": 1,
        "per_page": 2
    },
    "success": true,
    "status": 200

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

Ключ	Формат	Описание
id	string	id альбома
name	string	Название альбома
description	string	Описание альбома
create_date	string	Дата создания альбома
create_time	string	Время создания альбома (МСК)
privacy	string	Тип альбома
image_count	integer	Количество изображений в альбоме
link	string	Ссылка на альбом

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

Ключ	Формат	Описание
total	int	Количество изображений не в альбомах
total_pages	int	Количество страниц при пагинации
current_page	int	Текущая страница
per_page	int	Количество элементов на страницу

Коды ошибок:

Код	Текст ошибки	Описание
403	Invalid secret key	Неверный SECRET_KEY

Получение ID всех своих изображений.

GET https://api.imageban.ru/v1/account/me/images/ids/{PAGE}

Отображает массив ID всех изображений
В параметре {PAGE} (используется для пагинации) вы можете указать номер страницы с изображениями, номера начинаются с 1. По умолчанию отображаются 50 элементов.

Заголовок:

Authorization Bearer {SECRET_KEY}

Пример:

curl --location 'https://api.imageban.ru/v1/account/me/images/ids' \
--header 'Authorization: Bearer {SECRET_KEY}'

Ответ:

{
    "data":[
    "K642sMl",
    "7oct1tk",
    "tBJT1Hv"
    ],
    "success":true,
    "status":200
}

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

Ключ	Формат	Описание
data	mixed	id изображений

Коды ошибок:

Код	Текст ошибки	Описание
403	Invalid secret key	Неверный SECRET_KEY

Получение ID всех своих альбомов.

GET https://api.imageban.ru/v1/account/me/albums/ids/{PAGE}

Отображает массив ID всех альбомов
В параметре {PAGE} (используется для пагинации) вы можете указать номер страницы с альбомами, номера начинаются с 1. По умолчанию отображаются 50 элементов.

Заголовок:

Authorization Bearer {SECRET_KEY}

Пример:

curl --location 'https://api.imageban.ru/v1/account/me/albums/ids' \
--header 'Authorization: Bearer {SECRET_KEY}'

Ответ:

{
    "data":[
    "0ZzsiRv",
    "plDDdUd",
    "VTpCulJ"
    ],
    "success":true,
    "status":200
}

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

Ключ	Формат	Описание
data	mixed	id альбома

Коды ошибок:

Код	Текст ошибки	Описание
403	Invalid secret key	Неверный SECRET_KEY