Brings back an array containing every item on the Everygamegoing site that is compatible with the [machine_type_id] specified.
https://www.everygamegoing.com/api/getAllItemIDs/index/machine_type_id/[machine_type_id]/[library_name/[library_name]/] |
Note: The [machine_type_id] is mandatory. Refer to getAllMachines for further details.
Note: The [library_name] is optional and is discussed further below.
Note: There are many thousands of games for some machines (for example, Spectrum 48K). Use this call with caution. Make your call to this once, store the data and then parse it locally for items that may be of interest. Never build an application that calls this frequently.
The following call, substituting 338 (PlayStation 2 (EU Version) for the [machine_type_id]:
https://www.everygamegoing.com/api/getAllItemIDs/index/machine_type_id/338/ |
will return a response similar to the following:
{ "response": [ { "item_id":"74962", "show_title":".hack\/\/Infection" }, { "item_id":"74963", "show_title":".hack\/\/Mutation" }, { "item_id":"74964", "show_title":".hack\/\/Outbreak" }, ... { "item_id":"76300", "show_title":"Zapper: One Wicked Cricket" }, { "item_id":"76301", "show_title":"Zombie Hunters" }, { "item_id":"76302", "show_title":"Zombie Hunters 2 (UK Version)" }, { "item_id":"75609", "show_title":"Zoocube" } ] }
Key | Human-readable Explanation | Value Data Type | Value Example |
---|---|---|---|
item_id | Item ID | Integer | 74962 |
show_title | Show Title | String | .hack\/\/Infection |
Your application should find it easy to get any interesting Item IDs from the associative array in the response.
Whilst the above should satisfy most needs, there is an additional, optional parameter called [library_name]. This is a filter and including it will narrow down the subset of data which the call returns. This [library_name] is a string and must take one of the following values, which are listed below in order of importance:
The calls using the [library_name] parameter are best illustrated by examples.
Whether you apply the additional [library_name] filter is entirely up to you. Whether you use the optional parameter or not, note that this command is not intended to be regularly called.
The Item IDs can of course be used with the call to getItemByItemID to return much fuller information about any item.