IOT物联网-构造请求:请求URI

时间:2025-02-28 09:23:19

请求URI

请求URI由如下部分组成。

{URI-scheme}://{Endpoint}/{resource-path}?{query-string}

参数

说明

URI-scheme

传输请求的协议,当前所有API均采用HTTPS协议。

Endpoint

承载REST服务端点的服务器地址,为“host:port”格式,host为服务器的访问 域名 或IP,port为服务器的访问端口,您可以参考平台对接信息获取应用的接入地址和端口信息。

例如设备管理服务在“华北-北京四”区域的应用对接地址为“iot-api.cn-north-4.myhuaweicloud.com”,端口为“8743”,所以Endpoint为“iot-api.cn-north-4.myhuaweicloud.com:8743”

resource-path

资源路径,即API访问路径。从具体API的URI信息处获取,例如鉴权接口的resource-path为“/iocm/app/sec/v1.1.0/login”

query-string

查询参数,可选,格式为“参数名=参数取值”,例如“pageSize=10”,表示每页最多显示10条查询记录。

查询参数与resource-path之间以“?”分隔,多个查询参数之间以“&”分隔。

例如您需要获取“华北-北京四”区域设备管理服务的accessToken,查询到的Endpoint为“iot-api.cn-north-4.myhuaweicloud.com:8743”,并在鉴权接口的URI信息处找到resource-path为“/iocm/app/sec/v1.1.0/login”,拼接起来的请求URI如下所示。

https://iot-api.cn-north-4.myhuaweicloud.com:8743/iocm/app/sec/v1.1.0/login

批量查询设备信息接口为例,带query-string参数的请求URI如下所示。

https://iot-api.cn-north-4.myhuaweicloud.com:8743/iocm/app/dm/v1.4.0/devices?pageNo=0&pageSize=10
support.huaweicloud.com/api-IoT/iot_06_0090.html