История покупок скинов

Главное

Основная информация Генерация подписи

Депозиты

Начало работы Создание депозита Создание депозита без переадресации (iframe) Уведомление о депозите (webhook) Проверка статуса депозита Получение списка депозитов Депозиты без 8 дневного ожидания (Steam Trade Protection) Одобрение депозита с 8 дневным холдом Недошедшие уведомления о платежах

Депозиты без SkinsBack UI

Создание депозита без SkinsBack UI (API) Получить инвентарь пользователя

Вывод скинов

Прайс-лист (наличие скинов) Поиск скинов Купить скин Массовая покупка скинов Статус покупки скина История покупок скинов

Другое

Баланс проекта История выводов с баланса и депозитов Валюты и курсы Статус сервера Real-time обновления: WebSockets Real-time обновления: WebHooks

История покупок скинов

Информация по всем приобретенным вещам. Лимит на вывод 1000.

Синим выделены обязательные параметры.

Отправьте POST запрос на API Endpoint со следующими параметрами:

method

string

market_history

starting

int

UNIX время начала выборки

ending

int

UNIX время конца выборки

start_from

int

start_from параметр из ответа для навигации по страницам (количество результатов ограничено 1000)

Ответ от сервера:

В случае успеха, в ответе от сервера будет объект JSON, со следующим содержанием:

total_count

int

Всего результатов (количество результатов ограничено 1000)

has_more

bool

Есть ли еще следующие страницы для пагинации

start_from

int

Используется для навигации по страницам

items

array

Массив из элементов, описанных ниже

Объект 'items'

item

object

Объект, содержащий информацию о купленном скине

— item.id

int

Skin ID

— item.name

string

Название скина

— item.price

float

Цена скина в USD

— item.classid

string

Class ID скина

buy_id

int

ID покупки скина

offer_status

string

Статус покупки:
1. 'creating_trade' — обмен создается
2. 'waiting_accept' — обмен ожидает принятия
3. 'accepted' — обмен принят
4. 'canceled' — обмен отклонен юзером
5. 'timeout' — обмен не принят за 10 минут
6. 'invalid_trade_token' — неверный trade token
7. 'user_not_tradable' — пользователь имеет ограничения в системе обмена
8. 'trade_create_error' — ошибка создания обмена (попробуйте еще раз)
9. 'rollback_user' — скин возвращен обратно пользователем (Steam Trade Protection)
10. 'rollback_supplier' — скин возвращен обратно поставщиком (Steam Trade Protection)

in_hold

bool

Скин в холде или нет

in_hold_until

string (datetime)

Дата, до которой скин будет в холде (может быть сделан роллбэк)

error_reason

string

Причина (если присутствует):
1. 'user_cant_trade' - у пользователя есть ограничение на торговлю в Steam
2. 'private_inventory' - пользователю необходимо открыть инвентарь
3. 'user_trade_ban' - у пользователя Trade Ban
4. 'user_inventory_is_full' - инвентарь пользователя полный
5. 'too_many_failed_attempts' - слишком много неудачных попыток вывода для пользователя
6. 'skin_unavailable' - скин недоступен для покупки (или уже продан)

steamid

string

Steam ID пользователя

date

int

Дата покупки (UNIX время)

balance_debited_sum

float

Сумма, списаная с баланса проекта (USD)

tradeofferid

string

Trade Offer ID в Steam (есть только если обмен был создан)

custom_id

string

'custom_id' в вашей системе

Пример успешного ответа:

{
    "status": "success",
    "items": [
        {
            "item": {
                "id": "2713",
                "name": "AWP | Man-o'-war (Minimal Wear)",
                "price": "1325.61",
                "classid": "3496732101",
                "instanceid": "480085569"
            },
            "tradeofferid": "4169974564",
            "buy_id": "2",
            "offer_status": "user_not_tradable",
            "error_reason": "private_inventory",
            "steamid": "76561198050648523",
            "date": "1596623088"
        },
        {
            "item": {
                "id": "2713",
                "name": "AWP | Man-o'-war (Minimal Wear)",
                "price": "1325.61",
                "classid": "3496732101",
                "instanceid": "480085569"
            },
            "tradeofferid": "4169977670",
            "buy_id": "3",
            "offer_status": "canceled",
            "error_reason": null,
            "steamid": "76561198050648523",
            "date": "1596623246"
        },
    ],
    "total_count": "2000",
    "has_more": true,
    "start_from": 999
}

Список возможных ошибок:

missing_starting_or_ending

Отсутствует UNIX время начала или конца

стандартные ошибки:

-1

please_use_post_method

Необходимо использовать POST метод

-2

invalid_shopid

ID проекта не найден в системе

-3

invalid_signature

Неверно сформирована подпись

-4

shop_not_active

Проект неактивен

-5

invalid_method

Неверный API метод

-7

request_limit_reached

Превышен лимит запросов (500/в минуту)

-8

invalid_ip_address

Укажите IP адрес в настройках проекта

-9

under_maintenance

Сайт на обслуживании

-10

invalid_client_secret

Неверный передан заголовок X-CLIENT-SECRET