---
title: "批量导入设备"
method: POST
path: "/api/v1/things/device/info/multi-import"
tags: ["things/device/info", "thingsDeviceInfo"]
---

# 批量导入设备

`POST /api/v1/things/device/info/multi-import`

## Request body

- object
  - `file` string, binary, required

## Response `200`

A successful response.

- object
  - `code` integer
  - `data` DeviceMultiImportResp
    - `errdata` DeviceMultiImportRow[], required — 批量导入错误清单
      - `address` string, required — 【选填】设备所在详细地址
      - `deviceAlias` string, required — 【选填】设备别名
      - `deviceName` string, required — 【必填】设备名称
      - `gatewayDeviceName` string, required — 【选填】绑定的网关设备ID
      - `gatewayProductID` string, required — 【选填】绑定的网关产品ID(网关的设备ID全局唯一可不填)
      - `logLevel` string, required — 【选填】日志级别（关闭/错误/告警/信息/调试）
      - `position` string, required — 【选填】设备位置百度坐标（格式:经,纬）
      - `productID` string, required — 【必填】产品ID
      - `row` integer, required — 【提示】数据所在表格行
      - `secret` string, required — 【选填】设备秘钥
      - `tags` string, required — 【选填】设备标签（格式k1:v1;k2:v2;...）
      - `tips` string, required — 【提示】模板使用提示
    - `headers` DeviceMultiImportRow, required
      - `address` string, required — 【选填】设备所在详细地址
      - `deviceAlias` string, required — 【选填】设备别名
      - `deviceName` string, required — 【必填】设备名称
      - `gatewayDeviceName` string, required — 【选填】绑定的网关设备ID
      - `gatewayProductID` string, required — 【选填】绑定的网关产品ID(网关的设备ID全局唯一可不填)
      - `logLevel` string, required — 【选填】日志级别（关闭/错误/告警/信息/调试）
      - `position` string, required — 【选填】设备位置百度坐标（格式:经,纬）
      - `productID` string, required — 【必填】产品ID
      - `row` integer, required — 【提示】数据所在表格行
      - `secret` string, required — 【选填】设备秘钥
      - `tags` string, required — 【选填】设备标签（格式k1:v1;k2:v2;...）
      - `tips` string, required — 【提示】模板使用提示
    - `total` integer, required — 当前表格数据量
  - `msg` string

---

[API](https://skmtc.net/unitedrhino/apis/things-api.md) · [All operations](https://skmtc.net/unitedrhino/apis/things-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unitedrhino/things-api/versions/f3bdeb916389/schema)