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

Данный документ предназначен для разработчиков программ-трейдеров.

Если вы не понимаете, о чём здесь идёт речь, этот документ не для вас :)

Общие требования

  1. В настройках вашей программы должны быть поля для ввода пользовательских Partner ID и Secret key (их можно взять на странице доски).
  2. Количество запросов — не более 60 в минуту.
  3. Обязательно ротировать аккаунты, если их много. То есть если один игрок был куплен с аккаунта №1, то следующий должен быть куплен с аккаунта №2. Важно, чтобы аккаунты повторялись как можно реже: мы не хотим банов ни для покупателей, ни для поставщиков.
  4. В программе должен стоять лимит на минимальный период между покупками с одного аккаунта.

Метод pop

Метод pop позволяет «взять» одного случайного игрока с доски. Этот игрок исчезает с общей доски на 300 секунд, за это время вы должны его выкупить по buy now.

Пример запроса (HTTP GET):

https://www.futsell.ru/ffa19/api/pop/id/123/ts/1513454219/sign/1b2dcde742bc1479e00665e42593cc68/sku/FFA19PS4/

Параметры:

  • id — Partner ID
  • ts — текущее время (unix timestamp)
  • sign — подпись запроса: md5(id + secret key + ts)
  • sku — платформа: FFA19PCC, FFA19PS4 или FFA19XBO

Дополнительные параметры (передаются в виде GET-параметров):

  • min_buy — минимальная цена игрока
  • max_buy — максимальная цена игрока

Ответ возвращает обычный JSON. Пример:

{
    "error": "",
    "message": "1 player popped",
    "player": {
        "tradeId": 205974847240,
        "startingBid": 241000,
        "buyNowPrice": 248000,
        "currentBid": 241000,
        "expires": 12345,
        "assetId": 208421,
        "name": "Saúl",
        "itemId": 67317285,
        "rating": 84,
        "preferredPosition": "CM"
    }
}

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

{
    "error": "EMPTY",
    "message": "Queue is empty."
}
  • error — код ошибки (EMPTY, AUTH или SKU) — может быть пустым
  • message — статус запроса или дополнительная информация об ошибке
  • player — информация об игроке, которого вы взяли.