目录

查询资源包文件

功能介绍

查询资源包文件。

接口原型

承载协议

HTTP GET

接口方向

开发者服务器 ->华为服务器

接口URL

https://connect-api.cloud.huawei.com/api/games-background-assets-service/v1/open-gw/dev/{devId}/package-files

数据格式

请求消息:Content-Type: application/json

响应消息:Content-Type: application/json

请求参数

[h2]Header

参数名称

必选(M)/可选(O)

类型

参数说明

client_id

M

String

客户端ID,获取方法参考API客户端方式,其中“角色”支持勾选“APP管理员”、“管理员”、“运营”。

Authorization

M

String

认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。

[h2]Path

参数名称

必选(M)/可选(O)

类型

参数说明

devId

M

Long

开发者ID。

[h2]Query

参数名称

必选(M)/可选(O)

类型

参数说明

appId

M

String

游戏APP ID,获取方法参考查看应用信息。

versionId

O

Long

资源包版本ID。

说明:

versionId参数和fileIds参数,选择一个传入。

fileIds

O

String

资源包文件ID列表,使用英文逗号分隔。取值范围:[1,500]。

说明:

versionId参数和fileIds参数,选择一个传入。

page

O

Int

请求页码,默认值:1。

limit

O

Int

列表查询单页数量。取值范围:[1,100]。

默认值:20

请求示例

GET /api/games-background-assets-service/v1/open-gw/dev/12***3344/package-files/?appId=69***47 HTTP/1.1
Host: connect-api.cloud.huawei.com
client_id: 41*****7168
Authorization: Bearer ******

响应参数

参数名称

必选(M)/可选(O)

类型

参数说明

ret

M

GbasRet

包含返回码及描述信息的JSON字符串,格式为{"code":retcode, "msg": "description"},retcode为返回码,description为返回码描述信息。

data

M

GWOpGetPackageFilesRspData

查询资源包文件返回体。

响应示例

{
    "ret": {
      "code": 0,
      "msg": "success"
    },
    "data": {
      "resourceFiles": [
        {
          "fileId": "17***736",
          "fileName": "Demo",
          "versionId": "string",
          "fileLength": 0,
          "status": 0,
          "downLoadUrl": "string",
          "createTime": 1752841870000,
          "updateTime": 1752912491000
        }
      ],
      "totalCount": 1
    }
  }

调用示例

public static JSONObject getResourceFiles(String domain, String client_id, String token, String appId) {
    HttpGet httpReq = new HttpGet(domain + "/api/games-background-assets-service/v1/open-gw/dev/12***3344/package-files/?appId=" + appId);
    httpReq.setHeader("client_id", client_id);
    httpReq.setHeader("Authorization", "Bearer " + token);
    try {
        CloseableHttpClient httpClient = HttpClients.createDefault();
        CloseableHttpResponse httpResponse = httpClient.execute(httpReq);
        int statusCode = httpResponse.getStatusLine().getStatusCode();
        if (statusCode == HttpStatus.SC_OK) {
            BufferedReader br = new BufferedReader(new InputStreamReader(httpResponse.getEntity().getContent(), Consts.UTF_8));
            String result = br.readLine();

            JSONObject object = JSON.parseObject(result);
            return object;
        }
    } catch (Exception e) {
        e.printStackTrace();
    }
    return null;
}