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

Надежный хостинг изображений

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




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