文档中心 > API类目 > 阿里体育API

alibaba.alisports.stadium.banshu.device.register (设备注册接口)

设备注册接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_register_d_t_o RegisterDto 必须 入参包装类型
  • └ ip_address
  • String
  • 可选
  • 127.0.0.1
  • 本地ip地址
  • └ ipv6_address
  • String
  • 可选
  • ::1
  • 本地ipv6地址
  • └ mac_address
  • String
  • 可选
  • aa:aa:aa:aa:aa:aa
  • 设备mac地址
  • └ manufacture
  • String
  • 可选
  • alisports
  • 厂牌
  • └ model
  • String
  • 可选
  • ali-001
  • 类型
  • └ product_key
  • String
  • 必须
  • a_001
  • 阿里云iot产品key
  • └ remark
  • String
  • 可选
  • 备注
  • 备注
  • └ sdk_version
  • String
  • 可选
  • 1.0.0
  • 固件版本
  • └ sn
  • String
  • 必须
  • a_001
  • 设备序列号
  • └ version_code
  • String
  • 可选
  • 1.0.0
  • 应用版本号
  • └ version_name
  • String
  • 可选
  • 1.0.0
  • 应用版本名称
  • └ is_need_face
  • Boolean
  • 可选
  • true
  • 是否需要人脸
  • └ face_params
  • String
  • 可选
  • {"test":123}
  • 人脸参数

响应参数

名称 类型 示例值 描述
result BanshuResult 结果包装类
  • └ code
  • Number
  • 200
  • 请求结果
  • data
  • RegisterVo
  • 请求结果数据
  • └ device_name
  • String
  • device_0001
  • 阿里云iot平台设备名称,用于iot平台激活
  • └ display_id
  • String
  • 100001
  • 设备展示id
  • └ identifier_id
  • String
  • id_0001
  • 设备唯一设备id,用于参数传递
  • └ iot_id
  • String
  • iotId_001
  • 设备iotId
  • └ name
  • String
  • iot设备
  • 设备名称
  • └ secret
  • String
  • sec_0001
  • 阿里云iot设备密钥,用于iot平台激活
  • └ face_result_map
  • String
  • 人脸结果返回值
  • └ message
  • String
  • success
  • 请求结果信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlisportsStadiumBanshuDeviceRegisterRequest req = new AlibabaAlisportsStadiumBanshuDeviceRegisterRequest();
AlibabaAlisportsStadiumBanshuDeviceRegisterRequest.RegisterDto obj1 = new AlibabaAlisportsStadiumBanshuDeviceRegisterRequest.RegisterDto();
obj1.setIpAddress("127.0.0.1");
obj1.setIpv6Address("::1");
obj1.setMacAddress("aa:aa:aa:aa:aa:aa");
obj1.setManufacture("alisports");
obj1.setModel("ali-001");
obj1.setProductKey("a_001");
obj1.setRemark("备注");
obj1.setSdkVersion("1.0.0");
obj1.setSn("a_001");
obj1.setVersionCode("1.0.0");
obj1.setVersionName("1.0.0");
obj1.setIsNeedFace(true);
obj1.setFaceParams("{\"test\":123}");
req.setParamRegisterDTO(obj1);
AlibabaAlisportsStadiumBanshuDeviceRegisterResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alisports_stadium_banshu_device_register_response>
    <result>
        <code>200</code>
        <data>
            <device_name>device_0001</device_name>
            <display_id>100001</display_id>
            <identifier_id>id_0001</identifier_id>
            <iot_id>iotId_001</iot_id>
            <name>iot设备</name>
            <secret>sec_0001</secret>
            <face_result_map></face_result_map>
        </data>
        <message>success</message>
    </result>
</alibaba_alisports_stadium_banshu_device_register_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

返回
顶部