API подарков

API подарков позволяет купить Steam-игру и отправить её другому пользователю через ссылку для добавления в друзья Steam. Покупка происходит через намерение — сначала создаётся намерение, затем выставляется счёт на оплату.

Перед тем как создавать намерение, вы можете проверить доступность игры и получить актуальную цену с помощью метода проверки подарка.

Для того чтобы получить список доступных игр в каталоге, используйте метод загрузки каталога. Для получения информации о конкретной игре и её изданиях используйте метод получения информации об игре.

{
  "games": [
    {
      "appId": 292030,
      "slug": "steam-292030",
      "title": "The Witcher 3: Wild Hunt",
      "headerImage": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/292030/header.jpg",
      "shortDescription": "You are Geralt of Rivia, mercenary monster slayer.",
      "genres": ["RPG"],
      "price": {
        "paymentAmount": 199900,
        "paymentCurrency": "RUB",
        "paymentAmountFull": 299900,
        "discountPercent": 33
      }
    }
  ],
  "total": 42
}

Работа с изданиями

У каждой игры может быть несколько изданий (стандартное, делюкс, полное). Для просмотра всех доступных изданий и их цен используйте метод получения информации об игре с appId нужной игры.

{
  "appId": 292030,
  "slug": "steam-292030",
  "type": "game",
  "isDlc": false,
  "isFree": false,
  "requiredAge": 0,
  "title": "The Witcher 3: Wild Hunt",
  "shortDescription": "You are Geralt of Rivia, mercenary monster slayer.",
  "website": "https://thewitcher.com/en/witcher3",
  "media": {
    "header": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/292030/header.jpg",
    "capsule": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/292030/capsule_231x87.jpg",
    "background": "https://store.akamai.steamstatic.com/images/storepagebackground/app/292030",
    "screenshots": [
      {
        "thumbnail": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/292030/ss_1.600x338.jpg",
        "full": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/292030/ss_1.1920x1080.jpg"
      }
    ]
  },
  "genres": ["RPG"],
  "categories": ["Single-player", "Steam Achievements", "Full controller support"],
  "developers": ["CD PROJEKT RED"],
  "publishers": ["CD PROJEKT RED"],
  "release": {
    "date": "18 May, 2015",
    "comingSoon": false
  },
  "platforms": {
    "windows": true,
    "mac": false,
    "linux": false
  },
  "metacritic": {
    "score": 92,
    "url": "https://www.metacritic.com/game/the-witcher-3-wild-hunt/"
  },
  "recommendations": 850000,
  "achievements": 78,
  "editions": [
    {
      "edition": "Standard Edition",
      "packageId": 40499,
      "regions": [
        {
          "region": "US",
          "paymentAmount": 199900,
          "paymentCurrency": "RUB",
          "paymentAmountFull": 299900,
          "discountPercent": 33
        }
      ]
    }
  ]
}

При создании намерения необходимо передать packageId выбранного издания в поле target.packageId.

Работа с регионом

Поле target.region — двухбуквенный код страны по ISO 3166-1 alpha-2 (например, US, DE, TR). Регион влияет на доступность и цену игры. Рекомендуется запрашивать у геймера его регион или определять его автоматически.

Как работает доставка

После успешной оплаты наша система автоматически добавляется в друзья через переданную ссылку (target.inviteUrl) и отправляет игру в подарок. Геймер получает подарок в своей библиотеке Steam.

Информация

API пополнения

API товаров

API снаряжения