解析任务详情--云游戏-火山引擎

文档中心

立即注册

导航

解析任务详情

最近更新时间：2025.01.20 15:42:48首次发布时间：2022.03.01 17:40:52

获取游戏安装包文件解析任务的结果（异步）。

请求方式

使用 GET 方式发起请求。

请求参数

下表仅列出了接口特有的请求参数和部分公共参数。完整的公共参数列表，参考公共请求参数。

字段	位置	类型	必填	说明	值
Action	Query	String	是	公共参数，OpenAPI 接口名称	DetailParseTask
Version	Query	String	是	公共参数，OpenAPI 接口版本	2022-02-10
task_id	Query	String	是	任务 ID	通过调用 CreateParseTask 接口返回例：4pm8zzxobu

返回结果

通用返回参数，参考 ResponseMetadata 结构说明。

Result 字段包含以下参数：

字段	类型	说明
task_id	String	任务 ID
account_id	Int64	火山引擎账号 ID
url	String	所解析的 URL
step	String	解析任务运行步骤：空字符串（尚未开始解析） Init（解析任务初始化） download（开始下载） apk_parse（开始解析） md5（开始计算 MD5） done（任务完成）
process	Float64	解析任务运行步骤的进度百分比
code	Int32	解析任务运行状态： 0（运行正常） 2000000（任务解析异常） 2000001（下载过程异常） 2000002（打开文件异常） 2000003（获取文件信息异常） 2000004（解压文件异常） 2000005（获取包名异常） 2000006（获取包版本异常） 2000007（解析结果是测试包） 2000008（计算 MD5 异常）
package_name	String	游戏包名称
version_code	String	游戏版本号
version_name	String	游戏版本名称
md5	String	游戏文件 MD5
file_size	Int64	文件大小，单位KB
file_type	string	上传文件类型： .apk（APK 类型） .zip（APK+数据包类型） .tgz（APK+数据包类型） .tar（APK+数据包类型）
data_package	Object	游戏数据包信息，参考以下 DataPackage 结构说明
create_at	String	任务创建时间；格式为时间字符串，带时区
update_at	String	任务更新时间；格式为时间字符串，带时区

DataPackage 结构说明

字段	类型	说明
file_name	String	数据包文件名
size	Int64	数据包文件大小，单位 byte
md5	String	数据包文件文件 MD5

示例

请求示例

GET https://open.volcengineapi.com?Action=DetailParseTask
&Version=2022-02-10
&task_id=h8fboxxxx
&<通过header传入的公共请求参数>

返回示例

{
    "ResponseMetadata": {
        "Action": "DetailParseTask",
        "Region": "cn-north-1",
        "RequestId": "2023062016300333A6FE255642F73792A1",
        "Service": "veGame",
        "Version": "2022-02-10"
    },
    "Result": {
        "task_id": "h8fboxxxx",
        "product_id": "16308002740xxxxxxxx",
        "url": "https://xxx-file.xxx.com/cloudgame/xxxxxx.tar?x-expires=258xxxxxx&x-signature=xxxxxx",
        "step": "done",
        "process": 100,
        "code": 0,
        "package_name": "com.mygame.test1",
        "version_code": 1,
        "version_name": "1.0",
        "md5": "6ba27946c00acf6f9b8039f0xxxxxxxx",
        "file_size": 111844670,
        "file_type": ".tar",
        "create_at": "2023-06-16T17:35:02+08:00",
        "update_at": "2023-06-16T17:35:22+08:00",
        "data_package": [
            {
                "file_name": "main.mygame.test1.obb",
                "size": 58723043,
                "md5": "37b718e6f250a7926e72b0f7xxxxxxxx"
            }
        ]
    }
}