Artikelliste anhand von angegebener Gruppe abrufen

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

Ruft eine Artikelliste aus der angegebenen Gruppe zum Erstellen eines Katalogs ab.

Achtung: Bei allen Projekten ist die Anzahl der pro Antwort abrufbaren Elemente begrenzt. Der Standard- und Maximalwert beträgt 50 Elemente pro Antwort. Verwenden Sie die Felder limit und offset, um mehr Daten pro Seite abzurufen.

SecurityAuthForClient

Request

path Parameters

project_id required	integer Projekt-ID. Example: 44056
external_id required	string Default: "all" external ID der Gruppe.

query Parameters

limit	integer Obergrenze der Elementanzahl auf der Seite. Example: limit=50
offset	integer Elementnummer, aus der die Liste generiert wird (die Zählung beginnt bei 0). Example: offset=0
locale	string Default: "en" Antwortsprache. Sprachcode, bestehend aus zwei Kleinbuchstaben, gemäß ISO 639-1.
additional_fields[]	Array of strings Die Liste der zusätzlichen Felder. Diese Felder werden in der Antwort angezeigt, sofern sie in der Anfrage gesendet werden. Verfügbare Felder: `media_list`, `order`, `long_description`.
country	string Default: "US" Land, für das regionale Preise berechnet und Katalogeinschränkungen festgelegt werden. Ländercode, bestehend aus zwei Großbuchstaben, gemäß ISO 3166-1 Alpha-2. Wenn Sie das Land nicht explizit angeben, wird es anhand der IP-Adresse des Benutzers ermittelt.

Responses

200

Die Liste der Artikel aus der angegebenen Gruppe wurde erfolgreich empfangen.

404

Die Gruppe wurde nicht gefunden. Stellen Sie sicher, dass die external_id korrekt ist und die Gruppe nicht deaktiviert oder gelöscht ist.

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"
}
]
}
]
}