> ## Documentation Index
> Fetch the complete documentation index at: https://steamgold.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# API подарков

> Как купить Steam-игру в подарок другому пользователю через ссылку для добавления в друзья

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

<Info>
  Перед тем как создавать намерение, вы можете проверить доступность игры и получить актуальную цену с помощью метода [проверки подарка](/api-docs/gifts/verify).
</Info>

Для того чтобы получить список доступных игр в каталоге, используйте [метод загрузки каталога](/api-docs/gifts/catalog). Для получения информации о конкретной игре и её изданиях используйте [метод получения информации об игре](/api-docs/gifts/game).

```json theme={null}
{
  "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
}
```

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

У каждой игры может быть несколько изданий (стандартное, делюкс, полное). Для просмотра всех доступных изданий и их цен используйте [метод получения информации об игре](/api-docs/gifts/game) с `appId` нужной игры.

```json theme={null}
{
  "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.