API Документация

Изучите документацию и начните работу со Skinify

Покупка и вывод скина

Данный метод позволяет приобрести скин и отправить его пользователю Steam.

HTTP запрос

POST https://skinify.io/api/withdraw/buy

POST параметры

Параметр Обязательный Описание
partner check ‘partner’ параметр из Trade URL пользователя
token check ‘token’ параметр из Trade URL пользователя
name + game
или
id
check Название скина + game (dota2, csgo, rust, tf2)
или
ID скина из результатов поиска
max_price Максимальная цена покупки (в USD). Может использоваться для ограничения стоимости приобретаемого скина.
custom_id Уникальный ID из вашей системы. Может использоваться для предотвращения двойных покупок.

Ответ

Ответ от сервера будет содержать следующие данные:

Параметр Описание
skin Объект, содержащий информацию о приобретаемом скине
purchase_id ID покупки, который может использоваться в дальнейшем для получения статуса покупки
purchase_status
new
Статус покупки
1. processing — обмен в процессе создания
2. waiting_accept — ожидание принятия обмена пользователем
3. accepted — обмен был принят пользователем
4. canceled — обмен был отклонен пользователем
5. timeout — время ожидания принятия обмена закончилось (5 минут)
6. error_invalid_token — был передан неверный параметр ‘token’
7. error_user_not_tradable — пользователь имеет ограничения на принятие обменов
8. error_create_failed — проблема при создании обмена (попробуйте еще раз)
9. rollback_user — сделка отменена пользователем после принятия обмена через систему защиты обмена Steam
10. rollback_provider — сделка отменена исполнителем после принятия обмена через систему защиты обмена Steam
11. reserved
new
— предмет зарезервирован и ожидает снятия задержки обмена
12. reservation_canceled
new
— резервация предмета была отменена пользователем
13. error_item_unavailable
new
— предмет больше недоступен для покупки
date Дата покупки (unix timestamp)
balance_debited_amount Сумма, списанная с баланса проекта
custom_id Уникальный ID переданный вами
reserved_until
new
Метка времени (в формате Unix timestamp), указывающая, когда сделка перейдет из статуса reserved в статус processing
(существует только для сделок с резервацией)

Пример ответа

{
  "status": "success",
  "skin": {
    "id": "11552",
    "name": "Crimson Pique",
    "price": 0.3,
    "properties": {
    "classid":"1723113626"
    }
  },
  "purchase_id": 1,
  "purchase_status": "processing",
  "date": "1643714026",
  "balance_debited_amount": 0.3,
  "custom_id": "1234"
}

Возможные ошибки

Ошибка Описание
missing_skin_parameters Отсутствуют нужные параметры (name + game или id)
name_too_short Минимальная длина названия скина составляет 3 символа. Проверьте параметр ‘name’ и какие данные в него передаются
missing_partner_or_token Отсутствует параметр ‘token’ или ‘partner’
invalid_trade_token Значение параметра ‘token’ неверно
insufficient_funds Недостаточно средств на балансе проекта для приобретения скина
skin_unavailable Скин недоступен для приобретения
skins_not_found_at_specified_price Нет в наличии скинов, цена которых <= ‘max_price’
custom_id_exists Уже была совершена покупка с указанным custom_id
withdraw_unavailable Вывод скинов временно недоступен.