Steam api что это
Steam api что это
Last updated July 2010
1. Steam Web APIs. The Steam Web APIs are Valve’s service allowing licensees to retrieve certain data regarding Steam and games available via Steam («Steam Data»). The Steam Web APIs consist of multiple application program interfaces for retrieving various Steam Data, and presenting the Steam Data to end users via a web site, software application, or service owned and operated by you and identified in the your API key sign up form (the «Application»). These items are further defined in the Steam Web API documentation. Valve makes the Steam Web API available free, and you understand that Valve may change or terminate the Steam Web API entirely or your access in particular. Valve may identify new releases from time to time at this link, and may require you to use the most recent version. New versions may be incremental and consistent with older versions, but in some cases they may not be compatible with your previous implementation.
2. License to Steam Web API & Steam Data. Subject to these Terms of Use, you may access the Steam Web API, implement the Steam Web API in your Application, and distribute Steam Data to end users for their personal use via your Application, all in accordance with the Steam Web API documentation. This license is subject to the following restrictions:
3. License to Valve Brand & Links. You agree, and Valve grants you a license, to implement the Valve name(s), logo(s), and links to Valve (the «Valve Brand & Links») on any Web page incorporating the Steam Web API and/or Steam Data, in accordance with the Steam Web API documentation. You shall not tag links to Valve hereunder with a «nofollow» attribute or otherwise prevent or discourage search engines from following or scoring the link.
4. Acceptable Use. You agree not to use the Steam Web API, Steam Data, or Valve Brand & Links in any way that is unlawful, or harms Valve, developers and publishers of games via Steam, their service providers, their suppliers, end users, or any other person. Further, pursuant to Section 11 below, Valve may terminate your use of the Steam Web API, Steam Data and Valve Brand & Links at any time in Valve’s sole discretion.
5. Limited Relationship. You and Valve are independent contractors, and nothing in these API Terms of Use shall be construed as creating an employer-employee relationship, a partnership, or a joint venture. While you may publicly refer to the fact that you have implemented the Steam Web API, you agree not make any other public statements that assert or imply any other relationship with Valve, unless you have Valve’s prior written approval.
6. Indemnity. You agree to hold harmless and indemnify Valve, and its subsidiaries, affiliates, officers, agents, employees, and suppliers, from and against any third party claim arising from or in any way related to your or your users’ use of your Application or the Steam Web API or Steam Data, use of Valve Brand & Links other than as set forth in the Steam Web API Network Branding Requirements, violation of these API Terms of Use or other actions connected with use of Valve services, including any liability or expense arising from all claims, losses, damages (actual and consequential), suits, judgments, litigation costs and attorneys’ fees, of every kind and nature. In such a case, Valve will provide you with written notice of such claim, suit or action.
8. LIABILITY LIMITATION; EXCLUSIVE REMEDY. IN NO EVENT WILL VALVE OR ANY SUPPLIER BE LIABLE FOR ANY DAMAGES, INCLUDING WITHOUT LIMITATION ANY INDIRECT, CONSEQUENTIAL, SPECIAL, INCIDENTAL, OR PUNITIVE DAMAGES ARISING OUT OF, BASED ON, OR RESULTING FROM THESE API TERMS OF USE OR YOUR USE OF STEAM WEB API, STEAM DATA, OR VALVE BRAND & LINKS, EVEN IF SUCH PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE EXCLUSION OF DAMAGES UNDER THIS PARAGRAPH IS INDEPENDENT OF YOUR EXCLUSIVE REMEDY AND SURVIVES IN THE EVENT SUCH REMEDY FAILS OF ITS ESSENTIAL PURPOSE OR IS OTHERWISE DEEMED UNENFORCEABLE. THESE LIMITATIONS AND EXCLUSIONS APPLY WITHOUT REGARD TO WHETHER THE DAMAGES ARISE FROM (A) BREACH OF CONTRACT, (B) BREACH OF WARRANTY, (C) NEGLIGENCE, OR (D) ANY OTHER CAUSE OF ACTION, TO THE EXTENT SUCH EXCLUSION AND LIMITATIONS ARE NOT PROHIBITED BY APPLICABLE LAW. IF YOU DO NOT AGREE WITH ANY PART OF THESE API TERMS OF USE, OR YOU HAVE ANY DISPUTE OR CLAIM AGAINST VALVE OR ITS SUPPLIERS WITH RESPECT TO THESE TERMS OF USE OR THE SERVICES, THEN YOUR SOLE AND EXCLUSIVE REMEDY IS TO DISCONTINUE USING THE STEAM WEB API, STEAM DATA, AND VALVE BRAND & LINKS.
10. Changes. Valve reserves the right to change the API Terms of Use, and you are responsible for regularly reviewing these API Terms of Use. Your continued use of the Steam Web API and/or Steam Data after the effective date of such changes will constitute acceptance of and agreement to any such changes. If you don’t agree with any such changes, or to any of the terms in this Agreement, your only remedy is to discontinue using the Steam Web API, Steam Data, and Valve Brand & Links. Valve may suspend or discontinue the Steam Web API at any time to you and/or to others, without notice.
11. Termination. Valve may change, suspend or discontinue the Steam Web API and suspend or terminate your use of the Steam Web API, Steam Data, and/or Valve Brand & Links at any time for any reason, without notice. You may also terminate by ceasing to use the Steam Web API, Steam Data, and Valve Brand & Links, removing implementation of the Steam Web API from your Application, and deleting all copies of the Steam Data and Valve Brand & Links.
12. Choice of Law; Disputes. These API Terms of Use are governed by the laws of the State of Washington, USA. You agree to submit to exclusive jurisdiction and venue in the state and federal courts sitting in King County, Washington, USA for any and all disputes, claims and actions arising from or in connection with the Steam Web API, Steam Data, Valve Brand & Links, and/or these API Terms of Use. In any dispute arising under this Agreement, the prevailing party will be entitled to attorneys’ fees and expenses.
13. General. You represent that you have the authority to bind the organization (if any) identified in your API key sign up form. You agree not to export from anywhere any part of the Steam Web API, Steam Data, or Valve Brand & Links provided to you or any direct product thereof except in compliance with, and with all licenses and approvals required under, applicable export laws, rules and regulations. If any part of these API Terms of Use is determined to be invalid or unenforceable, then the invalid or unenforceable provision will be replaced with a valid, enforceable provision that most closely matches the intent of the original provision and the remainder of these API Terms of Use will continue in effect. The section titles in these API Terms of Use are solely used for the convenience of the parties and have no legal or contractual significance. Valve may assign these API Terms of Use, in whole or in part, at any time with or without notice to you. You may not transfer, assign, or delegate the API Terms of Use and your Steam Web API key to any third party. Valve’s failure to act with respect to a breach by you or others does not waive its right to act with respect to subsequent or similar breaches. Except as expressly stated herein, these API Terms of Use constitute the entire agreement between you and Valve with respect to the Steam Web API and Steam Data and supersede all prior or contemporaneous communications of any kind between you and Valve with respect to the Steam Web API, Steam Data, or Valve Brand & Links.
Steam api что это
Counter-Strike: Global Offensive
Пример:
Форма авторизации открывается в маленьком окне. Поле адреса страницы пустое. Логин и пароль не заполняются автоматически, если сохранены в браузере.
Чуть более продвинутая версия скам формы.Форма авторизации открывается в маленьком окне. Поле адреса поддельное, сделано в виде HTML элемента. Логин и пароль не заполняются автоматически, если сохранены в браузере.
Без действий со стороны пользователя, получить этот ключ невозможно.
Пользователь пополняет какой-нибудь сайт скинами, но деньги на сайт не приходят. Оказалось, он отправил их мошеннику, однако проверочный код трейда совпадал.
Как это происходит?
1) Пользователь нажимает кнопку пополнение счет на сайте
2) Бот сайта присылает пользователю трейд с секретным кодом
4) Мошенник, используя API ключ пользователя, отменяет трейд, который прислал бот настоящего сервиса
5) Мошенник меняет ник своего бота и присылает пользователю трейд с таким же проверочным кодом и с таким же списком вещей.
6) Пользователь принимает трейд, даже не замечая подмены. Процесс скорее всего полностью автоматизирован.
Еще можно попробовать продать что-то дорогое или пополнить счет с помощью SkinPay
Steam api что это
Valve provides these APIs so website developers can use data from Steam in new and interesting ways. They allow developers to query Steam for information that they can present on their own sites. At the moment the only APIs we offer provide item data for Team Fortress 2, but this list will grow over time.
Steam Web APIs available
ISteamNews: Steam provides methods to fetch news feeds for each Steam game.
ISteamUserStats: Steam provides methods to fetch global stat information by game.
ISteamUser: Steam provides API calls to provide information about Steam users.
ITFItems_440: Team Fortress 2 provides API calls to use when accessing player item data.
Obtaining an Steam Web API Key
All use of the Steam Web API requires the use of an API Key. You can acquire one by filling out this form. Use of the APIs also requires that you agree to the Steam API Terms of Use.
Output Formats
Format can be any of:
If you do not specify a format, your results will be returns in the JSON format.
Steam OpenID Provider
Steam can act as an OpenID provider. This allows your application to authenticate a user’s SteamID without requiring them to enter their Steam username or password on your site (which would be a violation of the API Terms of Use.) Just download an OpenID library for your language and platform of choice and use https://steamcommunity.com/openid as the provider. The returned Claimed ID will contain the user’s 64-bit SteamID. The Claimed ID format is: https://steamcommunity.com/openid/id/
Valve Brand and Links
If you are using OpenID on your site, we request that you use one of the following buttons as your link to the Steam sign in page.
Steam api что это
Введение
API Steamworks предоставляет играм все преимущества Steam благодаря доступу ко всем основным системам с помощью API. Сюда входят, к примеру, постановка игры на паузу в момент открытия пользователем оверлея Steam, приглашение друзей в игру, достижения Steam, соревнование игроков в списках лидеров Steam и так далее.
В разделе Справочник по API Steamworks задокументированы все интерфейсы, функции, обратные вызовы и типы, поддерживаемые в API.
Интеграция с API Steamworks не требуется для доставки продуктов пользователям Steam, но мы рекомендуем её реализацию, поскольку она позволяет удовлетворить ожидания пользователей Steam.
С чего начать
ВНИМАНИЕ: API Steamworks официально поддерживает C++, использование Microsoft Visual Studio 2008+ на Microsoft Windows, GCC 4.6+ и Clang 3.0+ на macOS и SteamOS / Linux. Если вы используете сторонние движки или отличные от C++ языки программирования, вам следует ознакомиться с разделом Commercial engine and non-C++ language support, где могут быть изложены инструкции, относящиеся к вашему движку или выбранному языку. В некоторых случаях вы можете пропустить некоторые из нижеследующих инструкций.
Инициализация и завершение работы
SteamAPI_Init
После того, как вы настроите API Steamworks в своём проекте, вы можете начать использовать его, вызывая SteamAPI_Init для инициализации. Это настроит глобальное состояние и заполнит его указателями интерфейсов, доступных с помощью глобальных функций, соответствующих названиям интерфейсов. Вызов SteamAPI_Init и получение сообщения о его успехе ОБЯЗАТЕЛЬНЫ до выполнения вызовов к другим интерфейсам!
SteamAPI_RestartAppIfNecessary
SteamAPI_RestartAppIfNecessary проверяет, запущен ли исполняемый файл через Steam, и если нет, перезапускает его в Steam.
Это необязательно, но крайне рекомендуется, поскольку контекст Steam (включая номер приложения) не будет настроен, если пользователь запустит исполняемый файл напрямую. Если это случится, вызов SteamAPI_Init не состоится, и вы не сможете использовать API Steamworks.
Если вы решите его использовать, это должен быть первый вызов Steamworks, выполняемый непосредственно перед SteamAPI_Init.
Если же будет возвращено значение false, игра была запущена клиентом, и никаких действий предпринимать не нужно. В то же время, если файл steam_appid.txt имеется в наличии, этот вызов всегда будет возвращать false. Это позволяет разрабатывать и тестировать игру без необходимости запускать её из клиента. Не забудьте удалить steam_appid.txt перед отправкой игры в хранилище Steam!
ВНИМАНИЕ: если вы используете оболочку DRM для первичного исполняемого файла, эта проверка необязательна, поскольку оболочка выполнит её самостоятельно.
SteamAPI_Shutdown
Когда вы завершите использование API Steamworks вы должны вызвать SteamAPI_Shutdown, чтобы освободить ресурсы, используемые приложением в Steam. Если возможно, вы должны сделать этот вызов при завершении процесса.
Этот вызов не отключит оверлей от приложения, поскольку нет гарантии, что ваш API выведения изображений перестал его использовать.
Интерфейсы Steamworks
API Steamworks состоит из множества интерфейсов, которые предоставляют ограниченную, конкретную функциональность.
Вы можете использовать интерфейсы для подобных вызовов:
Обратные вызовы
Обратные вызовы — один из самых важных элементов Steamworks, который позволяет получать данные из Steam асинхронно, без необходимости блокировать игру. Цель обратных вызовов в том, чтобы предоставить простой, легкий, типобезопасный, потокобезопасный метод представления событий любому объекту, зарегистрированному в качестве слушателя.
Обратные вызовы обычно срабатывают, когда то или иное событие происходит в Steam, к примеру когда друг входит в сеть или выходит из неё, или в результате функций API. Каждый обратный вызов состоит из структуры (struct), содержащей уникальный идентификатор и небольшой набор данных. Обратные вызовы объявлены в заголовочных файлах ISteam*.h и сгруппированы по интерфейсам, которым они принадлежат в наибольшей степени.
ВНИМАНИЕ: Обратите внимание: вы должны убедиться, что Steam инициализирован до того, как создавать объекты, которые слушают обратные вызовы.
Пример
Один из обратных вызовов, который вы, скорее всего, будете использовать, — это ISteamFriends::GameOverlayActivated_t. Как и подразумевает его название, он отправляется всякий раз, когда пользователь открывает или закрывает оверлей.
Результаты вызова
Многие методы Steamworks используют результаты вызова вместо обратных вызовов для отправки асинхронных результатов вызова функции. Разница между обратным вызовов и результатом вызова состоит в том, что обратные вызовы транслируются всем слушателям, а результаты вызова — только определённому слушателю. Как и в случае с обратными вызовами, игре необходимо вызвать SteamAPI_RunCallbacks для подготовки отправки результатов вызовов их слушателям.
ВНИМАНИЕ: Обратите внимание: обратные вызовы и результаты вызова не взаимозаменимы. Вы получите информацию о событии только так или иначе, но не с помощью обоих средств. Вы должны убедиться, что слушатель зарегистрирован для нужного типа события!
Результаты вызова должны быть созданы в качестве члена в структуре или классе при помощи типа CCallResult.
Пример
Manual Callback Dispatch
Steam Game Servers
The Steamworks API includes support for running game servers as well as regular clients. A game server, in Steamworks API terms, is an entity in the system that normal users connect to to play multi-player games. This can be connecting over the Internet to a remote game server, or connecting locally to a game server that’s in the same process as the client. Game servers have their own set of API functions to use, and their own unique Steam ID for other users to refer to them by.
See Приложение-образец с API Steamworks (SpaceWar) for a fully loaded example of using the game server API.
Unlike a game, a dedicated server will usually be run in an environment where there is no Steam Client installed to provide the latest steamworks binaries. In order for the dedicated server to have the latest steam binaries, you will need to include the Dedicated Server Redistributables with your app. Log into partner.steamgames.com and navigate to the technical settings for your app. Then look under «Installation / Redistributables» and check «Dedicated Server Redistributables»
Commercial engine and non-C++ language support
If you’re using a commercial game engine or a language other than C or C++ you will want to see what level of support for the Steamworks API is provided for it.
In some engines they provide native built-in support, for others you may need a third-party solution.
If your engine does not have native support you can use the Steam Web API to access many features that Steam supports.
Regardless of how the Steamworks SDK is implemented in your engine you will need to have the latest Steamworks SDK to upload your application to Steam.
ВНИМАНИЕ: If some of the software you are shipping on steam is available under a restrictive open source license then please see Распространение приложений с открытым кодом в Steam.
Here are some common engines that people routinely use to ship games on Steam and the relevant documentation on how to get started using the Steamworks SDK with them.
ВНИМАНИЕ: Valve does not in any way endorse any of these engines or the third-party solutions. This list is sorted exclusively by name, and is in no way comprehensive, it exists solely as a starting guide. Engines will only be listed if they include native support or have a third-party solution that fits the guidelines. Third-party solutions will only be listed if they are kept reasonably up to date with the Steamworks SDK, are freely available under a permissive license (See: Распространение приложений с открытым кодом в Steam), and have a thread on the Steamworks Discussion Board. We recommend that you consult the community to see which option would work best for your specific setup.
Движки:
Языки:
Flat interface for binding to other languages
The SDK has a few features to facilitate the creation of binding layers for other languages.
Technical Details
Steam uses a variety of techniques to expose functionality to your application. It’s by no means critical to understand exactly how the Steamworks API works but it’s fairly simple and can be useful in planning out how to code your game with Steam integration in mind.
Steam api что это
Введение
В Steam встроен основанный на HTTP веб-API, который может использоваться для доступа ко многим функциям Steamworks. Этот API содержит публичные методы, доступ к которым может получить любое приложение, способное отправить HTTP-запрос: к примеру, игровой клиент или сервер. Он также содержит защищённые методы, которые требуют аутентификации, и доступ к ним могут получить доверенные бэкенд-приложения.
Формат запроса
Как и API Steamworks на С++, веб-API разделён на множество интерфейсов, содержащих связанные методы. Формат URI для запроса к API таков:
Большинство методов поддерживают несколько обязательных и необязательных параметров. В зависимости от метода эти параметры необходимо отправлять в запросе как параметр GET или POST.
Аутентификация
Массивы параметров
Служебные интерфейсы
Обратите внимание, что JSON должен быть закодирован в виде URL. Поля key и format по-прежнему передаются как отдельные параметры. Запросы POST также поддерживаются.
Определить, является ли метод служебным, можно по названию: если в окончании названия есть «Service» ( к примеру IPlayerService), то метод поддерживает дополнительный способ передачи параметров. Параметры некоторых служебных методов имеют более сложную структуру, и для них обязателен этот дополнительный способ.
Пример запроса
В следующем примере запрос возвращает 3 последние новости о Team Fortress 2.
Запрос уточняет, что ответ должен быть в формате JSON, и включает в себя обязательный параметр appid (AppID Team Fortress 2 равен 440) и необязательный параметр — число возвращаемых результатов.
Дополнительная информация об этом вызове доступна здесь: ISteamNews/GetNewsForApp
Получение Steam ID пользователя
Соображения об адресах узлов веб-API и брандмауэрах
Публичный веб-API ( api.steampowered.com ) находится за пограничным сервером кэширования Akamai, так что IP-адреса, которые вы увидите, будут разниться в зависимости от того, где вы находитесь, а также от других факторов. IP-адреса могут часто меняться, так что если вы выполняете запросы из-за брандмауэра, ограничивающего исходящие запросы, продолжайте читать.
Список разрешений для IP-адресов
Мы позволяем добавлять в список разрешений IP-адреса для вызовов веб-API. Это дополнительный слой защиты на случай того, если ваш ключ веб-API попадёт в чужие руки. Он делает так, что принимаются только вызовы веб-API с разрешённых IP-адресов. Когда в список разрешений будет добавлен любой IP-адрес, запросы с остальных адресов будут блокироваться и возвращать ответ 403 (доступ запрещён).
Добавлять IP-адреса в список разрешений просто. На любой странице группы, у которой есть ключ веб-API, нажмите на кнопку «Управление ключом веб-API» и следуйте дальнейшим инструкциям.
У каждого ключа веб-API свой список разрешений, и добавлять в него что-либо необязательно.
Обратите внимание: добавление в список разрешений не гарантирует защиту ключа веб-API. Защищайте свой ключ и никому его не сообщайте, а если он попал в чужие руки — немедленно смените его.