지정된 그룹별로 아이템 목록 가져오기

get/v2/project/{project_id}/items/virtual_items/group/{external_id}

카탈로그를 작성하기 위해 지정된 그룹에서 아이템 목록을 가져옵니다.

주의 모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값 및 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 필드를 사용하세요.

SecurityAuthForClient

Request

path Parameters

project_id required	integer 프로젝트 ID. Example: 44056
external_id required	string Default: "all" 그룹 외부 ID.

query Parameters

limit	integer 페이지 요소 개수 제한. Example: limit=50
offset	integer 목록이 생성된 요소 개수(개수는 0부터 시작함). Example: offset=0
locale	string Default: "en" 응답 언어. ISO 639-1에 따른 두 글자의 소문자 언어 코드.
additional_fields[]	Array of strings 추가 필드 목록입니다. 이 필드는 요청보내면 응답에 포함됩니다. 사용 가능한 필드 `media_list`, `order`, `long_description`.
country	string Default: "US" 국가는 카탈로그에 대한 지역별 가격 및 제한 사항을 계산합니다. ISO 3166-1 alpha-2에 따른 2자리 대문자 국가 코드. 국가를 명시적으로 지정하지 않으면 사용자의 IP 주소를 기준으로 계산됩니다.

Responses

200

지정 그룹의 아이템 목록이 성공적으로 수신되었습니다.

404

그룹을 찾을 수 없습니다. external_id가 정확한지 그룹이 꺼져 있거나 삭제되지 않았는지 확인하세요.

Request samples

Response samples

application/json

{"items": [{"attributes": [{"external_id": "stack_size",
"name": "Stack size",
"values": [{"external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "5"
}
]
}
],
"description": "Big Rocket - description",
"groups": [{"external_id": "accessory",
"name": "Accessory"
}
],
"image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
"inventory_options": {"consumable": {"usages_count": 1
},
"expiration_period": {"type": "day",
"value": 1
}
},
"is_free": false,
"name": "Big Rocket",
"price": {"amount": "100.99",
"amount_without_discount": "100.99",
"currency": "USD"
},
"sku": "big_rocket",
"type": "virtual_good",
"virtual_item_type": "non_renewing_subscription",
"virtual_prices": [{"amount": 100,
"amount_without_discount": 100,
"description": "description",
"image_url": "http://image.png",
"is_default": true,
"name": "SHOTGUN FOR TRUE RAIDERS",
"sku": "vc_test",
"type": "virtual_currency"
}
]
},
{"attributes": [{"external_id": "stack_size",
"name": "Stack size",
"values": [{"external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "5"
}
]
},
{"external_id": "rating",
"name": "Rating",
"values": [{"external_id": "rating_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "3.9"
}
]
}
],
"description": "description",
"groups": [{"external_id": "accessory",
"name": "Accessory"
}
],
"image_url": "http://image.png",
"inventory_options": {"consumable": {"usages_count": 1
},
"expiration_period": {"type": "day",
"value": 1
}
},
"is_free": false,
"name": "SHOTGUN FOR TRUE RAIDERS",
"price": {"amount": "101.0",
"amount_without_discount": "101.0",
"currency": "USD"
},
"sku": "shotgun_raider",
"type": "virtual_good",
"virtual_item_type": "non_renewing_subscription",
"virtual_prices": [{"amount": 100,
"amount_without_discount": 100,
"description": "description",
"image_url": "http://image.png",
"is_default": true,
"name": "SHOTGUN FOR TRUE RAIDERS",
"sku": "vc_test",
"type": "virtual_currency"
},
{"amount": 200,
"amount_without_discount": 200,
"description": "description",
"image_url": "http://image.png",
"is_default": false,
"name": "SHOTGUN FOR TRUE RAIDERS",
"sku": "vc_test_2",
"type": "virtual_currency"
}
]
}
]
}