Изучите документацию и начните работу со Skinify
Данный метод позволяет приобрести скин и отправить его пользователю Steam.
POST https://skinify.io/api/withdraw/buy
| Параметр | Обязательный | Описание |
|---|---|---|
| partner | ‘partner’ параметр из Trade URL пользователя | |
| token | ‘token’ параметр из Trade URL пользователя | |
| name + game или id |
Название скина + 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 — сделка отменена пользователем после принятия обмена через систему защиты обмена Steam10. rollback_provider — сделка отменена исполнителем после принятия обмена через систему защиты обмена Steam11. 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 | Вывод скинов временно недоступен. |