Steamworks 문서
GetAssetClass/v0001
컨텍스트에 있는 임의 에셋 ID의 목록을 위한 에셋 클래스를 반환합니다.

호출: 보관함 UI

HTTP 메서드: GET

매개변수:

이름종류필수설명
keystring이것은 귀하가 파트너 사이트에 제공한 귀사 앱의 Steam 경제 설정에 있는 "자산 서버 키"입니다.
appiduint32에셋과 연관된 애플리케이션의 32비트 앱 ID.
contextiduint64에셋을 찾을 수 있는 컨텍스트의 64비트 ID.
asset_countuint32요청된 에셋의 수.
asset#uint32요청된 64비트 에셋 ID. 0에서 asset_count-1 사이의 각 숫자에 이러한 매개변수 중 하나가 존재하게 됩니다. (예: asset0, asset1, asset2)

반환값

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

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

예시 출력

{ "result": { "assets": [ { "id": 131363189, "owner": 76561198029978818, "class": [ { "name": "def_index", "value": "128" }, { "name": "quality", "value": "3" } ] } ] , "success": true } }