Steamworks 문서
GetContextContents/v0001
특정 사용자 컨텍스트의 모든 에셋 및 통화를 반환합니다.

호출: 거래 UI, 보관함 UI

HTTP 메서드: GET

매개변수:

이름종류필수설명
keystring이것은 귀하가 파트너 사이트에 제공한 귀사 앱의 Steam 경제 설정에 있는 "자산 서버 키"입니다.
appiduint32에셋과 연관된 애플리케이션의 32비트 앱 ID.
steamiduint64에셋을 반환할 사용자의 64비트 Steam ID.
contextiduint64에셋을 반환할 컨텍스트의 64비트 ID.

반환값

이 메서드의 출력은 JSON 형식으로 인코딩되어야 합니다.

응답:
  • 결과
    • success - 메서드가 성공일 때 true. 에셋 서버가 false를 반환하면, 그 원인을 설명하는 error를 문자열에 설정해야 합니다.
    • error - 실패 원인을 설명하는 문자열. 이 메시지는 Steamworks 사이트의 경제 탭에 있는 오류 이력에 기록됩니다.
    • assets - 지정한 컨텍스트의 하위 요소에 해당하는 에셋 모음.
      • id - 에셋의 64비트 ID.
      • class - 게임에 정의된 에셋 클래스 식별자 모음. 식별자는 게임에서
        정의합니다. 클래스 식별자가 GetAssetClassInfo/v0001(으)로 되돌아갈 때 에셋 정보
        (예: 어떤 종류의 아이템인지에 대한 설명)를 재현하기에 충분한 정보를 제공할 수 있으면 됩니다. 각 식별자에는 다음과 같은 필드가 있어야 합니다.
        • name - 클래스 식별자 중 이 부분의 이름.
        • value - 클래스 식별자 중 문자열로서 이 부분의 값.
        • instance - true인 경우 클래스 식별자를 ‘instance’로 가정하며, 이는
          일반적으로 아이템 거래 시 전송되지 않기 때문에 아이템의 거래 가치에 영향을 주지 않습니다.
          (기본값: false)
          참고: GetAssetClassInfo/v0001 응답 내 아이템의 market_hash_name에 궁극적으로 영향을 주는 에셋 클래스 속성은 인스턴스 데이터로 취급할 수 없습니다. 커뮤니티 장터는 market_hash_name에 아무런 영향을 주지 않는 인스턴스 속성에 의존합니다.
        Steam이 캐시할 수 있는 설명 정보를 최대로 늘리려면 클래스 식별자가 최대한 일반적이고 재사용 가능해야 합니다. 예를 들어, ‘itemid’와 같은 이름에 64비트 ID 값과 단일 속성을 가진 클래스는 피하세요. 대신 설명을 구성하기에 충분한 정보를 제공하는 방식으로 아이템의 종류를 설명하세요. 예를 들어, ‘종류’ = ‘검’과 ‘희귀도’ = ‘일반’의 에셋 클래스는 아이템의 인스턴스가 정확히 무엇인지 알지 않아도 아이템에 대한 설명을 만들기에 충분한 정보를 제공합니다.
      • amount(선택 사항) - 에셋의 스택 수. 사용자가 스택에서 최대 이 수만큼의 유닛을 거래할 수 있습니다. (기본값: 1)
    • currency (선택 사항) - 이 컨텍스트에 포함된 통화 유형의 모음. 사용자에게 특정 유형의 통화가 없고 게임 내 UI에서 이를 볼 수 있는 경우 여기에만 추가하도록 합니다. 통화를 표시하는 방법은 에셋과 매우 흡사하기 때문에 classid 필드를 제외하고 에셋에 해당하는 필드 목록이 통화에도 적용됩니다. 통화에는 다른 에셋 필드와 함께 다음 두 가지 필드가 사용됩니다.
      • id - 이 종류의 통화에 지정된 무부호 32비트 ID. ID는 게임 내에서 완전히 고유해야 합니다.
      • amount - 사용자가 소유한 이 종류의 통화량을 나타내는 64비트 정수입니다.

예시 출력

{ "result": { "assets": [ { "id": 131363189, "class": [ { "name": "def_index", "value": "128" }, { "name": "quality", "value": "3" } ] }, { "id": 131412933, "class": [ { "name": "def_index", "value": "155" }, { "name": "quality", "value": "3" } ] }, { "id": 556669733, "class": [ { "name": "def_index", "value": "583" }, { "name": "flags", "value": "1" }, { "name": "origin", "value": "1", "instance": true } ] }, ] , "success": true } }