API Hot.Game (v. 0.0.1)

Ми завжди хотіли зробити Hot.Game домом для ваших ігор. Але дім перетворюється на в’язницю, якщо у вас немає можливості покинути його в будь-який момент. Саме тому ми вирішили надати публічне безкоштовне API для всіх наших користувачів. Використовуючи його, ви можете автоматично працювати з каталогом: вивантажити всі ваші колекції, підписки та обрані ігри у зручному машинозчитуваному форматі JSON.

Але це, звісно ж, не все. Також ми надаємо кілька зручних методів для ентузіастів, яким потрібна інформація про найкращі ціни на ігри з розбивкою за регіонами. Вона буде корисною для багатьох, хто хоче створювати корисні інструменти для геймерів.

Також на цій сторінці ви знайдете інформацію про те, як інтегрувати ваш магазин з каталогом Hot.Game, а також про платні опції API.

Попередження: API перебуває на стадії альфа-тестування. Наразі ми не гарантуємо ані зворотну сумісність нових версій з попередніми, ані підтримку поточної версії. Уважно стежте за оновленнями та новинами в нашому блозі з Dev-звітами. Послуга надається безкоштовно «as is» виключно для некомерційного використання.

У найближчий час випуск стабільної версії (v.1.0.0) не планується.

У разі публічного використання зазначення джерела інформації (Hot.Game) є обов’язковим. У разі бажання використання нашого API в комерційних цілях або в продакшені — обов’язкове погодження через службу підтримки.

Базові принципи

Наразі багато API-методів доступні публічно, без необхідності будь-якої авторизації або отримання ключів/токенів доступу. Ми сподіваємося зберегти це й надалі, але у разі зловживань нам доведеться обмежити доступ лише для зареєстрованих користувачів.

Авторизація для методів, які її потребують, у API не передбачена. Таким чином, такі методи наразі підходять лише для використання в браузерних розширеннях і букмарклетах. У майбутньому ми плануємо додати можливість авторизації користувача в певному вигляді безпосередньо через API.

Параметри задаються у вигляді URL-параметрів (query string), якщо інше не зазначено в описі методу та параметрів (багато параметрів задаються безпосередньо як частина шляху). Квадратні дужки в шаблонах означають необов’язкову частину посилання.

Приклад запиту на JS

Наведемо приклад авторизованого запиту. Нагадаємо, такі запити можливі лише в браузерних розширеннях або букмарклетах. У випадку розширень цей код має виконуватися в background-контексті розширення або в content-контексті сторінки Hot.Game, коли користувач авторизований.

async function fetchHotGameApi(url) {
    try {
        const r = await fetch(url, {
            method: 'GET',
            credentials: 'include',
        });

        if (!r.ok) {
            return {isError: true, status: r.status, message: `HTTP error ${r.status}`};
        }

        return await r.json();
    } catch (e) {
        console.error('Some error occured', e);
        return { isError: true, error: e };
    }
}
fetchHotGameApi('https://api.hot.game/user/my-games').then(console.log);

Типи даних

Валюти:

value

description

EUR

Євро (€)

KZT

Тенге (₸)

RUB

Рублі (₽)

UAH

Гривні (₴)

USD

Долари ($)

Регіони:

value

description

Без регіональних обмежень (Region free)

cis

СНД

Україна

Росія

all

Усі регіони

Типи колекцій:

value

description

–

Якщо тип не вказано (значення null) — це стандартна колекція

not_played

Ігри, у які користувач не грав. Генерується автоматично під час деяких дій користувача

not_interested

Ігри, які не цікавлять користувача. Генерується автоматично під час деяких дій користувача

want_to_play

Ігри, що цікавлять користувача. Генерується автоматично під час деяких дій користувача

Отримання основної інформації про API

https://api.hot.game/

parameter

type

required

description

Цей метод дозволяє отримати основну інформацію: поточну версію, дату останнього оновлення, посилання на інформацію про нього (якщо був відповідний допис у нашому блозі).

Також важливим полем є nextAPIIncompatibleUpdate, яке може містити або значення false (у разі, якщо не заплановано несумісних змін в API), або об’єкт з інформацією про таке оновлення. Звісно, ми намагатимемося звести кількість таких оновлень до мінімуму. Але якщо ви не хочете вручну відстежувати наші Dev-звіти, це чудовий спосіб налаштувати автоматичну перевірку та сповіщення про критичні зміни.

https://api.hot.game/

{
  "title": "Hot.Game API",
  "description": "This is API of Hot.Game Service.",
  "version": "0.0.1",
  "lastAPIUpdateDate": "25 Nov 2025 22:21:34 GMT",
  "lastAPIUpdateDateTimestamp": 1764109294,
  "lastUpdateDetails": "link_on_post_on_hgn",
  "nextAPIIncompatibleUpdate": {
    "version": "0.0.2",
    "details": "link_on_post_on_hgn",
    "plannedUpdateDate": "26 Nov 2025 22:21:34 GMT",
    "plannedUpdateDateTimestamp": 1764195694
  },
  "documentation": "https://hot.game/api",
  "support": "support@hot-game.info"
}

Отримання всього каталогу ігор

https://api.hot.game/method/all-games

parameter

type

required

description

Цей метод дозволяє отримати список УСІХ ігор у нашому каталозі. Інформації про кожну гру небагато, але згодом ви можете скористатися іншими методами для отримання детальніших даних про потрібні вам ігри.

https://api.hot.game/method/all-games

[
    {
        "HGID":4783,
        "title":"Evan\u0027s Remains",
        "slug":"Evans-Remains",
        "hg_link":"https:\/\/hot.game\/game\/Evans-Remains"
    },
    {
        "HGID":6408,
        "title":"Doom 3: VR Edition",
        "slug":"Doom-3-VR-Edition",
        "hg_link":"https:\/\/hot.game\/game\/Doom-3-VR-Edition"
    },
    ...
]

Отримання основних даних про гру

https://api.hot.game/game/{game-slug}/main-info

parameter

type

required

description

game-slug

String

yes

Game Slug можна знайти в посиланні гри на Hot.Game. Посилання на ігри формуються за такою формулою: https://hot.game/game/{game-slug}

* вказується в посиланні замість {game-slug}

currency

Валюта

optional

Валюта конвертації (сконвертовані ціни доступні в полі converted_price).

Основна інформація, доступна в цьому методі, — це, звісно ж, інформація про мінімальну ціну гри з розбивкою за регіонами та платформами.

У полі converted_price (міститься в кожній ціні) знаходиться масив з інформацією про сконвертовану ціну у вашу поточну валюту. Алгоритм визначення поточної валюти доволі складний. Якщо ви хочете гарантовано отримати конкретну валюту, краще вказувати параметр currency.

Ми не рекомендуємо покладатися на поле HGID; розглядається можливість його видалення в майбутньому та, можливо, заміни на більш універсальний ідентифікатор.

https://api.hot.game/game/Hogwarts-Legacy/main-info

{
  "HGID": 5805,
  "title": "Hogwarts Legacy",
  "alt_title": "Хогвартс Наследие",
  "slug": "Hogwarts-Legacy",
  "release_date": "2023-02-10",
  "min_prices_by_region": {
    "all": [
      {
        "currency": "RUB",
        "currency_symbol": "₽",
        "price": 445,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 445
        },
        "percent_discount": 87,
        "platform": "windows",
        "region": "Все регионы",
        "region_code_name": "all",
        "region_short_name": "ВСЕ"
      },
      {
        "currency": "RUB",
        "currency_symbol": "₽",
        "price": 4339,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 4339
        },
        "percent_discount": 30,
        "platform": "nintendo_switch",
        "region": "Все регионы",
        "region_code_name": "all",
        "region_short_name": "ВСЕ"
      },
      {
        "currency": "RUB",
        "currency_symbol": "₽",
        "price": 710,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 710
        },
        "percent_discount": 89,
        "platform": "ps_4",
        "region": "Все регионы",
        "region_code_name": "all",
        "region_short_name": "ВСЕ"
      },
      {
        "currency": "RUB",
        "currency_symbol": "₽",
        "price": 6499,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 6499
        },
        "percent_discount": 0,
        "platform": "nintendo_switch_2",
        "region": "Все регионы",
        "region_code_name": "all",
        "region_short_name": "ВСЕ"
      },
      {
        "currency": "RUB",
        "currency_symbol": "₽",
        "price": 502,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 502
        },
        "percent_discount": 93,
        "platform": "xbox_sx",
        "region": "Все регионы",
        "region_code_name": "all",
        "region_short_name": "ВСЕ"
      },
      {
        "currency": "RUB",
        "currency_symbol": "₽",
        "price": 828,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 828
        },
        "percent_discount": 86,
        "platform": "ps_5",
        "region": "Все регионы",
        "region_code_name": "all",
        "region_short_name": "ВСЕ"
      },
      {
        "currency": "RUB",
        "currency_symbol": "₽",
        "price": 710,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 710
        },
        "percent_discount": 89,
        "platform": "xbox_one",
        "region": "Все регионы",
        "region_code_name": "all",
        "region_short_name": "ВСЕ"
      }
    ],
    "ua": [
      {
        "currency": "UAH",
        "currency_symbol": "₴",
        "price": 239,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 445
        },
        "percent_discount": 85,
        "platform": "windows",
        "region": "Украина",
        "region_code_name": "ua",
        "region_short_name": "UA"
      },
      {
        "currency": "UAH",
        "currency_symbol": "₴",
        "price": 269,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 502
        },
        "percent_discount": 93,
        "platform": "xbox_sx",
        "region": "Украина",
        "region_code_name": "ua",
        "region_short_name": "UA"
      },
      {
        "currency": "UAH",
        "currency_symbol": "₴",
        "price": 2438,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 4544
        },
        "percent_discount": 29,
        "platform": "xbox_one",
        "region": "Украина",
        "region_code_name": "ua",
        "region_short_name": "UA"
      }
    ],
    "cis": [
      {
        "currency": "RUB",
        "currency_symbol": "₽",
        "price": 524,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 524
        },
        "percent_discount": 85,
        "platform": "windows",
        "region": "СНГ",
        "region_code_name": "cis",
        "region_short_name": "СНГ"
      },
      {
        "currency": "RUB",
        "currency_symbol": "₽",
        "price": 1108,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 1108
        },
        "percent_discount": 84,
        "platform": "xbox_sx",
        "region": "СНГ",
        "region_code_name": "cis",
        "region_short_name": "СНГ"
      },
      {
        "currency": "RUB",
        "currency_symbol": "₽",
        "price": 4544,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 4544
        },
        "percent_discount": 29,
        "platform": "xbox_one",
        "region": "СНГ",
        "region_code_name": "cis",
        "region_short_name": "СНГ"
      }
    ],
    "ww": [
      {
        "currency": "USD",
        "currency_symbol": "$",
        "price": 8.99,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 710
        },
        "percent_discount": 85,
        "platform": "windows",
        "region": "Без региональных ограничений (Region free)",
        "region_code_name": "ww",
        "region_short_name": "Мир"
      },
      {
        "currency": "USD",
        "currency_symbol": "$",
        "price": 8.99,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 710
        },
        "percent_discount": 85,
        "platform": "ps_4",
        "region": "Без региональных ограничений (Region free)",
        "region_code_name": "ww",
        "region_short_name": "Мир"
      },
      {
        "currency": "USD",
        "currency_symbol": "$",
        "price": 10.49,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 828
        },
        "percent_discount": 88,
        "platform": "xbox_sx",
        "region": "Без региональных ограничений (Region free)",
        "region_code_name": "ww",
        "region_short_name": "Мир"
      },
      {
        "currency": "USD",
        "currency_symbol": "$",
        "price": 10.49,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 828
        },
        "percent_discount": 85,
        "platform": "ps_5",
        "region": "Без региональных ограничений (Region free)",
        "region_code_name": "ww",
        "region_short_name": "Мир"
      },
      {
        "currency": "USD",
        "currency_symbol": "$",
        "price": 8.99,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 710
        },
        "percent_discount": 89,
        "platform": "xbox_one",
        "region": "Без региональных ограничений (Region free)",
        "region_code_name": "ww",
        "region_short_name": "Мир"
      }
    ],
    "ru": [
      {
        "currency": "RUB",
        "currency_symbol": "₽",
        "price": 4339,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 4339
        },
        "percent_discount": 30,
        "platform": "nintendo_switch",
        "region": "Россия",
        "region_code_name": "ru",
        "region_short_name": "RU"
      },
      {
        "currency": "RUB",
        "currency_symbol": "₽",
        "price": 2399,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 2399
        },
        "percent_discount": 63,
        "platform": "ps_4",
        "region": "Россия",
        "region_code_name": "ru",
        "region_short_name": "RU"
      },
      {
        "currency": "RUB",
        "currency_symbol": "₽",
        "price": 6499,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 6499
        },
        "percent_discount": 0,
        "platform": "nintendo_switch_2",
        "region": "Россия",
        "region_code_name": "ru",
        "region_short_name": "RU"
      },
      {
        "currency": "RUB",
        "currency_symbol": "₽",
        "price": 2899,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 2899
        },
        "percent_discount": 52,
        "platform": "ps_5",
        "region": "Россия",
        "region_code_name": "ru",
        "region_short_name": "RU"
      },
      {
        "currency": "RUB",
        "currency_symbol": "₽",
        "price": 5999,
        "converted_price": {
          "currency": "RUB",
          "currency_symbol": "₽",
          "price": 5999
        },
        "percent_discount": 0,
        "platform": "xbox_one",
        "region": "Россия",
        "region_code_name": "ru",
        "region_short_name": "RU"
      }
    ]
  },
  "hg_link": "https://hot.game/game/Hogwarts-Legacy"
}

Отримання даних про мою гру

https://api.hot.game/game/{game-slug}/my-game

parameter

type

required

description

game-slug

String

yes

«Інформація про мою гру» — це інформація про ваші «взаємовідносини» з конкретною грою. Чи додали ви її до обраного (поле saved) або відстежуваних (поле subscription), чи оцінили ви її (поле rating[vote]) і чи додали її до якихось із ваших колекцій (поле collections).

https://api.hot.game/game/Hogwarts-Legacy/my-game

{
  "saved": true,
  "subscription": {
    "new_games": false,
    "region": "all",
    "currency": "UAH",
    "platforms": [
      "windows"
    ]
  },
  "rating": {
    "value":2.8,
    "vote": 4,
    "max": 4,
    "min": 1
  },
  "collections": [
    {
      "slug": "382d97",
      "name": "Это на Новый Год 🎄"
    }
  ]
}

Отримання моїх ігор

https://api.hot.game/user/my-games[/{filters}][/{page}]

parameter

type

required

description

page

Integer

optional

Задає номер сторінки. Якщо не вказано — буде повернута перша сторінка.

* вказується в посиланні замість {page}

filters

Special

optional

Якщо вказано, задає фільтри та сортування. Ідентичний рядку фільтрів на сайті, тому не будемо наводити доволі складні принципи побудови. Ви можете вивчити їх, скориставшись фільтрами на сайті.

* вказується в посиланні замість {filters}

Список ваших ігор відображається по 100 ігор на сторінку.

https://api.hot.game/user/my-games/2

{
  "my_games": [
    {
      "title": "Gothic 1 Remake",
      "slug": "Gothic-Remake",
      "hg_link": "https://hot.game/game/Gothic-Remake"
    },
    ...
  ],
  "page": 2,
  "page_size": 100,
  "total_my_games_number": 382
}

Отримання списку моїх колекцій

https://api.hot.game/user/my-collections

parameter

type

required

description

Список ваших колекцій з усією необхідною інформацією. Поле type містить значення тип колекції.

https://api.hot.game/user/my-collections

{
  "collections": [
    {
      "slug": "a01d9c",
      "name": "На позже",
      "public": false,
      "exclude_from_filters": false,
      "games_count": 2,
      "type": null
    },
    {
      "slug": "0c9976",
      "name": "Не играл",
      "public": false,
      "exclude_from_filters": false,
      "games_count": 531,
      "type": "not_played"
    },
    {
      "slug": "713345",
      "name": "Не интересует",
      "public": false,
      "exclude_from_filters": false,
      "games_count": 23,
      "type": "not_interested"
    },
    {
      "slug": "5e5c13",
      "name": "Самая лучшая коллекция в мире",
      "public": true,
      "exclude_from_filters": false,
      "games_count": 1,
      "type": null
    },
    {
      "slug": "7b58e9",
      "name": "Хочу поиграть",
      "public": false,
      "exclude_from_filters": false,
      "games_count": 44,
      "type": "want_to_play"
    },
    {
      "slug": "382d97",
      "name": "Это на Новый Год 🎄",
      "public": true,
      "exclude_from_filters": false,
      "games_count": 9,
      "type": null
    }
  ]
}

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

https://api.hot.game/collection/{collection-slug}[/{page}]

parameter

type

required

description

collection-slug

String

yes

Collection Slug можна знайти в посиланні колекції на Hot.Game. Посилання на колекції формуються за такою формулою: https://hot.game/collection/{collection-slug}

* вказується в посиланні замість {collection-slug}

page

Integer

optional

Задає номер сторінки. Якщо не вказано — буде повернута перша сторінка.

* вказується в посиланні замість {page}

Інформація про колекцію. Ігри відображаються по 100 ігор на сторінку. Якщо колекція не є публічною (поле public — false), вам знадобиться авторизація.

https://api.hot.game/collection/382d97

{
  "slug": "382d97",
  "name": "Это на Новый Год 🎄",
  "public": true,
  "exclude_from_filters": false,
  "games_count": 9,
  "type": null,
  "page": 1,
  "page_size": 100,
  "games_in_collection": [
    {
      "HGID": 5805,
      "title": "Hogwarts Legacy",
      "slug": "Hogwarts-Legacy",
      "hg_link": "https://hot.game/game/Hogwarts-Legacy"
    },
    {
      "HGID": 3,
      "title": "Grand Theft Auto V",
      "slug": "grand-theft-auto-5",
      "hg_link": "https://hot.game/game/grand-theft-auto-5"
    },
    {
      "HGID": 3595,
      "title": "S.T.A.L.K.E.R. 2: Heart of Chornobyl",
      "slug": "STALKER-2-Heart-of-Chernobyl",
      "hg_link": "https://hot.game/game/STALKER-2-Heart-of-Chernobyl"
    },
    {
      "HGID": 2496,
      "title": "Baldur's Gate III",
      "slug": "Baldurs-Gate-3",
      "hg_link": "https://hot.game/game/Baldurs-Gate-3"
    },
    {
      "HGID": 9798,
      "title": "Grand Theft Auto VI",
      "slug": "Grand-Theft-Auto-VI",
      "hg_link": "https://hot.game/game/Grand-Theft-Auto-VI"
    },
    {
      "HGID": 9498,
      "title": "Indiana Jones and the Great Circle",
      "slug": "Indiana-Jones-and-the-Great-Circle",
      "hg_link": "https://hot.game/game/Indiana-Jones-and-the-Great-Circle"
    },
    {
      "HGID": 71,
      "title": "The Witcher 3: Wild Hunt",
      "slug": "the-wtcher-3-wild-hunt",
      "hg_link": "https://hot.game/game/the-wtcher-3-wild-hunt"
    },
    {
      "HGID": 9877,
      "title": "Mafia: The Old Country",
      "slug": "Mafia-The-Old-Country",
      "hg_link": "https://hot.game/game/Mafia-The-Old-Country"
    },
    {
      "HGID": 9879,
      "title": "Alkahest",
      "slug": "Alkahest",
      "hg_link": "https://hot.game/game/Alkahest"
    }
  ]
}

Платні опції

Якщо вам недостатньо публічно доступних методів, ви можете звернутися до нашої служби підтримки із запитом на розширений доступ або унікальний функціонал. Якщо у вас буде невелике прохання, яке легко реалізувати, ми з радістю просто допоможемо вам.

Але якщо вас цікавлять великі обсяги інформації, особливо цінні дані з нашого каталогу або довгострокова підтримка (загалом, якщо ви хочете використовувати API для створення комерційного проєкту), доступ до такого API буде платним на договірній основі. Орієнтовна ціна: $20–$100 на місяць.

Інтеграція вашого магазину з каталогом

Якщо ви володієте магазином (або є його представником) і хочете, щоб ваші пропозиції відображалися в нашому каталозі, будь ласка, напишіть у нашу службу підтримки будь-яким зручним для вас способом. Ми зможемо детальніше обговорити умови підключення та допоможемо з будь-якими технічними питаннями.

Магазини додаються до каталогу лише після попередньої перевірки адміністрацією. Точні вимоги та перевірки ми не розголошуємо з міркувань безпеки. Але загалом ваш магазин має бути надійним (не шахрайським), а якість послуг — не нижчою за задовільний рівень (мається на увазі швидкість відповіді підтримки, частота помилок тощо).

Hot.Game підтримує 3 способи інтеграції з магазинами (парсингу даних): посторінковий HTML-парсер (legacy, зберігається для кількох старих магазинів, нові не додаються), роботу з API (переважно для офіційних магазинів із системами активації), парсер XML-фідів і JSON-фідів (основний і найефективніший спосіб).

Дані, які ми парсимо з фіда:

value

required

description

url

yes

Посилання на товар у вашому магазині

title

optional (recommended)

Назва товару у вашому магазині. Хоча це поле є необов’язковим, воно вкрай рекомендоване. Без нього швидке ручне додавання буде неможливим (і більше ваших пропозицій не потраплять до каталогу).

price

yes

Ціна товару у вашому магазині

price_old

optional

Базова повна ціна товару (без знижки). Значення враховується лише в офіційних магазинах із платформами активації (Steam, EGS, ...).

available

required / optional

Наявність товару в магазині (доступність до покупки). Якщо це поле відсутнє, в XML-фіді не повинно бути товарів, недоступних до покупки. Наполегливо рекомендуємо використовувати саме це значення (а не просто видаляти товар з XML), оскільки це набагато надійніше.

region

required / optional

Регіон активації. Без цього значення ваші пропозиції відображатимуться лише в псевдорегіоні УСІ, і абсолютна більшість наших користувачів їх не побачить.

Регіони можуть бути представлені в будь-якому вигляді. Але рекомендований формат: "регіон, регіон (крім виключений_регіон, виключений_регіон)". Іноді потрібно вказати регіон без якоїсь його частини — саме для цього використовується формулювання «крім». Наприклад, "Весь світ (крім Німеччини)" або "Європа, СНД (крім РФ та РБ)". Слово «крім» можна замінити на «excluding» або інше. Можливе налаштування парсера під ваш конкретний формат. Головне, щоб він був стабільним і стандартизованим, а не вказувався для кожної гри у довільній формі з різними формулюваннями.

activation

optional (recommended)

Система активації (Steam, EGS, GOG, Xbox, ...). Багато наших користувачів хочуть знати систему активації ще до переходу на сайт магазину. Відсутність цієї інформації може зменшити привабливість ваших пропозицій.

platform

optional (recommended)

Для яких ігрових платформ призначений товар (Windows, Linux, PS4, Xbox S|X, ...). Якщо вони вказані, додавання ваших цін до каталогу буде значно швидшим (інакше нашим модераторам доведеться проставляти платформи вручну для кожної ціни).

type

required / optional

Тип товару: ключ, гіфт, товар з доставкою. Поле є обов’язковим, якщо у вас є товари з доставкою. Якщо всі товари доставляються в цифровому вигляді — поле необов’язкове (хоча все ще рекомендоване).

currency

optional

Наразі це значення практично не використовується. Передбачається, що у фідах ціни вказані в одній (заздалегідь відомій) валюті.

external_id

optional

Зовнішні ID товару: це можуть бути app_id/sub_id/bundle_id у Steam, ідентифікатори в EGS тощо. І, звісно ж, HGID (ID товару на Hot.Game) — найнадійніший ідентифікатор.

Наявність цих ID дозволить зробити додавання ваших пропозицій повністю автоматичним. Але ви маєте знати, що ці ID повинні бути дуже точними. У нашому каталозі, наприклад, не допускається змішування Deluxe-видань зі стандартними. Тобто ID має точно відповідати КОНКРЕТНОМУ ТОВАРУ.

promo_end_timestamp

optional

Час завершення акції/знижки. Наразі не враховується; у майбутньому планується відображення цієї інформації в каталозі. Це поле враховуватиметься лише в тих магазинах, де ця інформація є достовірною.

Приклади фідів:

...
<response>
    ...
    <game>
        <title>Assassin's Creed: Syndicate</title>
        <url>link_to_item_in_shop</url>
        <price>487.00</price>
        <available>1</available>
        <region>Ukraine, Russia + CIS</region>
        <activation>Uplay</activation>
        <platform>windows</platform>
        <version>key</version>
    </game>
    <game>
        <title>Assassin's Creed: Unity</title>
        <url>link_to_item_in_shop</url>
        <price>453.00</price>
        <available>1</available>
        <region>Region Free</region>
        <activation>Uplay</activation>
        <platform>windows</platform>
        <version>key</version>
    </game>
    <game>
        <title>Assetto Corsa - Ultimate Edition</title>
        <url>link_to_item_in_shop</url>
        <price>681.00</price>
        <available>0</available>
        <region>Russia + CIS (excluding Azerbaijan and Tajikistan)</region>
        <activation>Steam</activation>
        <platform>windows</platform>
        <version>key</version>
    </game>
    ...
</response>

...
[
    ...
    {
      "title": "Assassin's Creed: Syndicate",
      "url": "link_to_item_in_shop",
      "price": 487.00,
      "available": true,
      "region": "Ukraine, Russia + CIS",
      "activation": "Uplay",
      "platform": "windows",
      "version": "key",
      "steam_app_id": "368500"
    },
    {
      "title": "Assassin's Creed: Unity",
      "url": "link_to_item_in_shop",
      "price": 453.00,
      "available": true,
      "region": "Region Free",
      "activation": "Uplay",
      "platform": "windows",
      "version": "key",
      "steam_app_id": "289650"
    },
    {
      "title": "Assetto Corsa - Ultimate Edition",
      "url": "link_to_item_in_shop",
      "price": 681.00,
      "available": false,
      "region": "Russia + CIS (excluding Azerbaijan and Tajikistan)",
      "activation": "Steam",
      "platform": "windows",
      "version": "key",
      "steam_app_id": "244210",
      "steam_bundle_id": "6998"
    },
    ...
]
...

Додаткові можливості:

За запитом ми надаємо магазинам модераторські облікові записи, використовуючи які вони можуть самостійно додавати нові пропозиції зі своїх магазинів (дотримуючись правил нашого каталогу). Також вони можуть примусово оновлювати ціни на особливо важливі товари, не чекаючи планового оновлення (яке відбувається кілька разів на добу).

Зміст

Вступ
Основні дані
Доступні методи
Платні опції
Інтеграція магазину з каталогом