文件管理 - 获取文件上传URL

获取文件上传URL

sys/{product_id}/{device_id}/thing/file/upload

说明：

已通过认证的设备，可以通过此Topic获取文件上传的链接与临时访问凭证

示例：

{
  "id": "123"
}

字段说明

参数	类型	说明
id	String	消息ID号。String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。

获取文件上传URL响应

sys/{product_id}/{device_id}/thing/file/upload/response

返回示例：

{
    "id": "123",
    "data": {
        "expire": 1716914308737,
        "uploadUrl": "https://example.chn-das.com/api/iot-device/devicemanage/v1/file/upload-from-device?deviceId=IHk4621240692085484171266&instance=test",
        "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpbnN0YW5jZSI6InRlc3QiLCJleHAiOjE3MTY5MTQzMDgsImRldmljZUlkIjoiSUhrNDYyMTI0MDY5MjA4NTQ4NDE3MTI2NiIsImp0aSI6ImM1NjU2NzczLTk5MDUtNDM0YS1iNzY3LTAxYTBiOGRjZmQ5MCIsInRlbmFudCI6InQxNzYzNDQ2MjY0ODgzNDk5MDEwIn0.ceNkOAkOIPtwV6NW-MkFsncqzodkzHouVOG1M89_sho"
    }
}

说明

服务端响应子设备获取文件上传URL

字段说明：

参数	类型	说明
id	String	消息ID号。String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性
data	Object	返回数据
expire	Long	凭证过期时间（毫秒级时间戳）
uploadUrl	String	上传文件时使用的URL
token	String	上传文件时需携带的token

文件上传接口说明

:::tip
上传时直接使用MQTT响应报文的URL即可
:::

HTTP Method: POST
Content-Type: multipart/form-data

字段说明

请求参数：

参数	类型	说明
deviceId	String	设备ID，MQTT响应报文URL已自动追加
instance	String	实例ID，MQTT响应报文URL已自动追加
deviceFile	File	进行上传的文件
keepTime	Integer	文件保留时间，单位：秒

HEADER参数

参数	类型	说明
Authorization	String	Bearer + 响应Topic返回的Token

响应参数：

参数	类型	说明
uri	String	文件路径（相对路径，若需要从外部访问，使用请求URL中的HOST部分 + /OSS + 相对路径即可，例如可以使用 https://example.chn-das.com/oss/iot-device-test/lWVin97ZBa6fL6Ud15FbFukhe/IHk4621240692085484171266/2024/05/22/ad19e91a207f38832c9e2e0478fa98e6.jpg 获取到上传的文件）

示例