文档中心 > API类目 > 智能设备

alibaba.retail.device.alility.call (调用设备能力)

调用设备的能力,能力包括了贩卖机出货、冰柜开门、视频播放、日志上传等等。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
device_code_list String [] 必须 ["123456"]
  • 最大列表长度:20
  • 设备编码列表
    ability_code String 必须 external.box.lock.open 能力编码
    params String 必须 {"boxId":[1,2,3]} 能力调用入参,JSON字符串格式

    响应参数

    名称 类型 示例值 描述
    result Result 接口返回结果,最外层Result对象
    • module
    • AbilityCallResp
    • 接口返回结果包装对象
    • └ message_id
    • String
    • 接口返回的真正结果,即调用设备能力后产生的消息id,后续可根据该id查询调用详情
    • warning_infos
    • ErrorInfo []
    • 接口调用警告信息列表
    • └ error_code
    • String
    • 错误码
    • └ error_message
    • String
    • 错误描述
    • error_infos
    • ErrorInfo []
    • 接口调用错误信息列表
    • └ error_code
    • String
    • 错误码
    • └ error_message
    • String
    • 错误描述
    • └ success
    • Boolean
    • false
    • 接口调用是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaRetailDeviceAlilityCallRequest req = new AlibabaRetailDeviceAlilityCallRequest();
    req.setDeviceCodeList(""123456"");
    req.setAbilityCode("external.box.lock.open");
    req.setParams("{\"boxId\":[1,2,3]}");
    AlibabaRetailDeviceAlilityCallResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_retail_device_alility_call_response>
        <result>
            <module>
                <message_id></message_id>
            </module>
            <warning_infos>
                <error_info>
                    <error_code></error_code>
                    <error_message></error_message>
                </error_info>
            </warning_infos>
            <error_infos>
                <error_info>
                    <error_code></error_code>
                    <error_message></error_message>
                </error_info>
            </error_infos>
            <success>false</success>
        </result>
    </alibaba_retail_device_alility_call_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

    返回
    顶部