Documentation

Support

Multiplay Clanforge

Open Clanforge

Multiplay Clanforge

Image options

Documentation for Image options
Read time 1 minuteLast updated 2 months ago

Get all available image options for the specified game image version.
https://api.multiplay.co.uk/cfp/v1/image/options

Request parameters

METHOD
GET
VARIABLEDESCRIPTIONOPTIONAL
accountserviceidThe
<accountserviceid>
parameter accepts an account service ID (ASID) associated with the specified resource. The credentials in the request header must have access to the ASID to perform the request.
No
gameidThe
<gameid>
parameter accepts a game ID. The provided game ID is used to filter the options in the response.

This parameter is required if you specify the
<imageid>
parameter.
Yes 1
imageidThe
<imageid>
parameter accepts a game image ID. The provided game image ID is used to find machines that have the specified image installed.

If you specify this parameter, you must also include the
<gameid>
parameter.
Yes 1
gameversion_identifierThe
<gameversion\_identifier>
parameter accepts a game version ID for which the mods are valid.

If you specify this parameter, you must also specify the
<gameid>
and
<imageid>
parameters.
Yes
1 If
<imageid>
is provided,
<gameid>
must also be provided, and vice versa.

Response fields

Field

Type

Description

Optional

diffidintegerID of the diff which the provided image ID is locked byYes
updateidintegerID of the update which the provided image ID is locked byYes
update_urlstringInformation about the update of an imageYes
gamesarrayList of game objects availableNo
imagesarrayList of image objects relating to a provided Game IDNo
machinesarrayList of machine objects usable as build boxYes

Game object

Field

Type

Description

Optional

gameidintegerID of the gameNo
namestringName of the gameNo

Image object

Field

Type

Description

Optional

imageidintegerID of the imageNo
namestringName of the imageNo
gameversionidstringID of the game version that this image usesNo

Machine object

Field

Type

Description

Optional

machineidintegerID of the machineNo
namestringName of the machineNo

Example request

curl --location --request GET 'https://api.multiplay.co.uk/cfp/v1/image/options?accountserviceid=<accountserviceid>&gameid=<gameid>&imageid=<imageid>&gameversion_identifier=<GameVersionIdentifier>' \
--header 'Authorization: Basic YOUR_AUTH_CREDENTIALS'

Example response

{
    "diffid": <diffid>,
    "updateid": <updateid>,
    "update_url": <updateurl>,
    "games" : [
        {
            "gameid" : <gameid>,
            "name" : <game_name>
        },
        ...
    ],
    "images" : [
        {
            "imageid" : <imageid>,
            "name" : <image_name>,
            "gameversionid" : <gameversionid>
        },
        ...
    ],
    "machines" : [
        {
            "machineid" : <machineid>,
            "name" : <machine_name>
        },
        ...
    ]
}

Image options • Multiplay Clanforge • Unity Docs