文档中心 > API类目 > 电影票API

taobao.film.terminal.version.get (机具客户端版本检测接口)

机具客户端更新程序通过该接口获取客户端的版本信息,进行客户端的更新操作

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
terminal_id String 必须 TB000001 机具编号

响应参数

名称 类型 示例值 描述
data TerminalVersionResponse data 返回参数模型
  • └ interval
  • Number
  • 1
  • 接口调用频率
  • └ md5_code
  • String
  • ED903AEDB5C276F33AE60F63C6B24C41
  • 更新包的md5码
  • └ url
  • String
  • http://taobaodianying.alicdn.com/terminal/version/1111.zip
  • 更新包的下载地址
  • └ version
  • String
  • 3.0.0
  • 版本号
result_code String 1 请求处理的异常代码
result_desc String 操作成功 请求处理的异常信息
status Number 1 本次交互是否有异常:1-成功,0-异常
terminal_sys_version TerminalSysVersionResponse terminal_sys_version 返回参数模型
  • patch_list
  • TerminalSysPatchDetailResponse []
  • patch_list
  • 返回参数模型
  • └ md5_code
  • String
  • 12312312
  • md5
  • └ size
  • Number
  • 1024
  • 补丁大小byte
  • └ url
  • String
  • http://taobaodianying.alicdn.com/terminal/version/1111.zip
  • 补丁url
  • └ name
  • String
  • test.zip
  • 补丁名称
  • └ gmt_modified
  • Date
  • 2019-07-08 12:12:12
  • 更新时间
  • └ gmt_create
  • Date
  • 2019-07-08 12:12:12
  • 创建时间
  • └ id
  • Number
  • 1231
  • id
  • └ issue_sys_version
  • String
  • 1.1.1.2
  • 目标机具系统版本
  • └ count
  • Number
  • 100
  • 补丁总数
  • └ type
  • String
  • lien
  • 机具供应商id
  • └ version
  • String
  • 1.0.0
  • 补丁版本号
  • └ id
  • Number
  • 12
  • id
  • └ execute_flag
  • Boolean
  • true
  • 是否执行补丁
  • └ download_flag
  • Boolean
  • true
  • 是否下载补丁

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmTerminalVersionGetRequest req = new FilmTerminalVersionGetRequest();
req.setTerminalId("TB000001");
FilmTerminalVersionGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<film_terminal_version_get_response>
    <data>
        <interval>1</interval>
        <md5_code>ED903AEDB5C276F33AE60F63C6B24C41</md5_code>
        <url>http://taobaodianying.alicdn.com/terminal/version/1111.zip</url>
        <version>3.0.0</version>
    </data>
    <result_code>1</result_code>
    <result_desc>操作成功</result_desc>
    <status>1</status>
    <terminal_sys_version>
        <patch_list>
            <terminal_sys_patch_detail_response>
                <md5_code>12312312</md5_code>
                <size>1024</size>
                <url>http://taobaodianying.alicdn.com/terminal/version/1111.zip</url>
                <name>test.zip</name>
                <gmt_modified>2019-07-08 12:12:12</gmt_modified>
                <gmt_create>2019-07-08 12:12:12</gmt_create>
                <id>1231</id>
            </terminal_sys_patch_detail_response>
        </patch_list>
        <issue_sys_version>1.1.1.2</issue_sys_version>
        <count>100</count>
        <type>lien</type>
        <version>1.0.0</version>
        <id>12</id>
        <execute_flag>true</execute_flag>
        <download_flag>true</download_flag>
    </terminal_sys_version>
</film_terminal_version_get_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部