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

Сервис Account

Получение профиля пользователя.

GET https://api.imageban.ru/v1/account/me/profile

Описание: Получаем информацию о профиле пользователя.

Заголовок

Authorization Bearer {SECRET_KEY}

Пример:

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

Ответ:

{
    "data": {
        "id": "123",
        "user_key": "some_user_key",
        "login": "Username",
        "display_name": "User Display Name",
        "email": "user@email.com",
        "regtime": "YYYY-MM-DD",
        "avatar": "avatar_url.jpg",
        "status": "1",
        "balance": "100.00",
        "total_size": "2048",
        "blocked": "0"
    },
    "success": true,
    "status": 200
}

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

Ключ	Формат	Описание
id	string	ID пользователя
user_key	string	Уникальный ключ пользователя
login	string	Логин пользователя
display_name	string	Имя если аккаунт авторизован через соц. сети
email	string	Email пользователя
regtime	string	Дата регистрации
avatar	string	Имя файла аватара
status	string	Статус аккаунта
balance	string	Баланс пользователя
total_size	string	Общий занятый размер файлов в байтах
blocked	string	Статус блокировки (1 - заблокирован, 0 - нет)

Коды ошибок:

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

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

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",
            "url_thumb": "https://i1.imageban.ru/thumbs/2025.05.23/3adf091e7f2102ac372f1e1e8fb2592b.jpg",
            "link": "https://i1.imageban.ru/out/2025/05/23/3adf091e7f2102ac372f1e1e8fb2592b.jpg",
            "short_link": "https://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",
            "url_thumb": "https://i1.imageban.ru/thumbs/2025.05.23/4fe2044bffc59d7c2b9300bf617d41e9.jpg",
            "link": "https://i1.imageban.ru/out/2025/05/23/4fe2044bffc59d7c2b9300bf617d41e9.jpg",
            "short_link": "https://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",
            "password": "123",
            "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	Тип альбома
password	string	Пароль альбома если тип secret
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

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

GET https://api.imageban.ru/v1/account/me/images/count

Описание: Получаем общее количество загруженных изображений пользователя.

Заголовок:

Authorization Bearer {SECRET_KEY}

Пример:

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

Ответ:

{
    "data": 154,
    "success": true,
    "status": 200
}

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

GET https://api.imageban.ru/v1/account/me/albums/count

Описание: Получаем общее количество созданных альбомов пользователя.

Заголовок:

Authorization Bearer {SECRET_KEY}

Пример:

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

Ответ:

{
    "data": 12,
    "success": true,
    "status": 200
}

Получение количества изображений в избранном.

GET https://api.imageban.ru/v1/account/me/favorites/count

Описание: Получаем общее количество изображений, добавленных в избранное.

Заголовок:

Authorization Bearer {SECRET_KEY}

Пример:

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

Ответ:

{
    "data": 45,
    "success": true,
    "status": 200
}