일부 웹 API 매서드는 공개적으로 접근 가능한 데이터를 반환하며 호출 시 인증이 필요하지 않습니다. 고유 API 키가 있어야 사용할 수 있는 메서드도 있습니다. 또한 중요한 데이터를 반환하거나 보호된 작업을 진행하는 메서드와 특별한 사용 권한이 필요한 매서드도 있습니다. 이러한 API 메서드는 배급사 키가 필요하며, 호출하기 전에 생성해야 합니다. API 키가 필요한 경우, 표준 매개변수 또는 'x-webapi-key' 요청 헤더 값을 설정하여 제공할 수 있습니다.
사용자 키
일반 사용자 키는 모두가 사용할 수 있으며, Steam 계정과 해당 키와 연관된 도메인 이름만 있으면 됩니다.
Steam 웹 API 이용 약관에도 동의해야 합니다.
Steam 웹 API 키 등록 페이지에서 사용자 웹 API 키를 만들 수 있습니다.
배급사 키
안전하게 배급사를 식별하고 보호된 매서드에 접근하기 위해서는, 키 매개 변수를 사용하여 적절한 메서드로 전달될 수 있도록 배급사가 웹 API 키를 요청해야 합니다. 각각의 키는 배급사 그룹과 연결되어 있으며, 해당 그룹과 연결된 모든 앱 ID에 대한 데이터에 접근하는 데 사용될 수 있습니다. 배급사 웹 API 키를 받으려면 아래에서 '배급사 키 발급'을 확인해주세요.
배급사 웹 API 키는 중요한 사용자 데이터 및 보호된 매서드에 대한 사용 권한을 제공합니다. 이러한 키는 보안 배급사 서버에서 요청한 웹 API 요청에 사용됩니다. 키는 안전하게 보관해야 하며, 게임 클라이언트와 함께 배포해서는 안 됩니다. 웹 API 키를 포함한 모든 웹 API 요청은 HTTPS를 통해 이루어져야 합니다.
배급사 웹 API 키 발급
배급사 웹 API 키를 발급하려면 Steamworks 계정에 관리자 권한이 있어야 합니다. 관리자가 아닌 경우, Steamworks 홈페이지 오른쪽에 있는 목록에서 파트너 계정의 관리자 목록을 확인할 수 있습니다. 목록에 있는 모든 관리자가 배급사 웹 API 키를 발급할 수 있으며, 필요한 경우 다른 계정에 관리자 권한을 부여할 수 있습니다.
배급사 웹 API 키 발급 방법:
- Steamworks 계정에 관리자 권한이 있는 사용자가 '사용자 및 권한'에서 '그룹 관리'를 선택하여 그룹 목록으로 이동합니다.
- 그룹 목록에서 웹 API 키를 사용하여 접근하려는 앱 ID가 포함된 그룹을 선택하거나 생성하세요.
- 그다음 해당 그룹을 클릭하여 그룹에 속해 있는 사용자 및 애플리케이션을 확인하세요.
- 관리자 권한이 있는 경우, 오른쪽에 '웹 API 키 발급' 옵션이 표시됩니다. 이전에 키를 발급한 경우, 키 목록을 확인할 수 있습니다.
