配置文件列表
警告：此处的 API 文档适用于 Clanforge。如果使用 Multiplay Hosting，请参阅 Multiplay Hosting API 文档。
使用可选过滤器获取 <accountserviceid> 的所有配置文件。
https://api.multiplay.co.uk/cfp/v1/profile/list方法 |
| GET |
请求参数
| 变量 | 描述 | 可选 |
| accountserviceid | <accountserviceid> 参数接受与指定资源关联的帐户服务 ID (ASID)。请求标头中的凭据必须具备 ASID 访问权限才能执行请求。 | 否 |
| profileid | <profileid> 参数接受一个或多个配置文件 ID。如果为此参数指定值，则响应正文将只包含所提供配置文件 ID 的相关信息。 | 是 |
| modid | <modid> 参数接受一个或多个模组 ID。如果为此参数指定值，则响应正文将只包含与所提供模组 ID 关联的配置文件的相关信息。 | 是 |
| game_build | <game_build> 参数接受一个或多个游戏版本。如果为此参数指定值，则响应正文将只包含与所提供游戏版本关联的配置文件的相关信息。 | 是 |
| settings | <settings> 参数接受布尔值。如果设为 如果设为 | 是 |
响应字段
| 字段 | 类型 | 描述 | 可选 |
|---|---|---|---|
| profiles | 数组 | 配置文件对象的列表 | 否 |
配置文件对象
| 字段 | 类型 | 描述 | 可选 |
|---|---|---|---|
| profileid | 整数 | 配置文件的 ID | 否 |
| gameversionid | 整数 | 与此配置文件关联的游戏版本的 ID | 否 |
| name | 字符串 | 此配置文件的名称 | 否 |
| modid | 整数 | 与此配置文件关联的模组的 ID | 否 |
| gameid | 整数 | 与此配置文件关联的游戏的 ID | 否 |
| gametype_identifier | 字符串 | 此配置文件的游戏类型标识符 | 否 |
| settings | 对象 | 包含从设置名称字符串到设置值字符串的映射 | 否 |
| fleetid | 字符串 | 与此配置文件关联的机群 ID | 否 |
请求示例
curl --location --request GET 'https://api.multiplay.co.uk/cfp/v1/profile/list?accountserviceid=<accountserviceid>&settings=<settings>&game_build=<game_build>' \
--header 'Authorization: Basic YOUR_AUTH_CREDENTIALS'响应示例
{
"profiles": [
{
"profileid": <profileid>,
"gameversionid": <gameversionid>,
"name": <name>,
"modid": <modid>,
"gameid": <gameid>,
"gametype_identifier": <gametype_identifier>,
"settings": {
"setting1": <setting_value>,
"setting2": <setting_value>,
...
},
"fleetid": <fleetid>
},
...
]
}