鉴权
接口说明
应用服务器首次访问物联网平台的开放API时，需调用此接口完成认证鉴权，获取accessToken。
注意事项
鉴权接口是调用其他API的前提，除了调用鉴权接口，其他接口调用都需要在request header中携带参数app_key和Authorization。app_key取值与请求参数中appId相同，Authorization的格式为Authorization: Bearer {accessToken}，其中accessToken通过调用鉴权接口获取到的。
如果多次获取accessToken，则之前的accessToken失效，最后一次获取的accessToken才有效。请勿并发获取accessToken。
URI
|
请求方法 |
POST |
|---|---|
|
URI |
/iocm/app/sec/v1.1.0/login |
|
传输协议 |
HTTPS |
请求参数
|
参数 |
必选/可选 |
类型 |
位置 |
描述 |
|---|---|---|---|---|
|
appId |
必选 |
String(256) |
body |
访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。 |
|
secret |
必选 |
String(256) |
body |
访问物联网平台的应用密钥，与appId对应，在物联网平台创建应用时由平台分配获得。 |
响应参数
Status Code: 200 OK
|
参数 |
类型 |
描述 |
|---|---|---|
|
scope |
String(256) |
申请权限范围，即accessToken所能访问物联网平台资源的范围，参数值固定为default。 |
|
tokenType |
String(256) |
accessToken的类型，参数值固定为Bearer 。 |
|
expiresIn |
Integer(256) |
accessToken的有效时间，参数值固定为3600秒。 |
|
accessToken |
String(256) |
鉴权参数，访问物联网平台API接口的凭证。 |
|
refreshToken |
String(256) |
鉴权参数，有效时间为24小时，用于“刷新Token”接口。当accessToken即将过期时，可通过“刷新Token”接口来获取新的accessToken。 |
请求示例
POST https://{host}:{port}/iocm/app/sec/v1.1.0/login
Content-Type: application/x-www-form-urlencoded
appId=******&secret=******
正常响应示例
Status Code: 200 OK
Content-Type: application/json
{
"scope": "default",
"tokenType": "Bearer ",
"expiresIn": 3600,
"accessToken": "*******",
"refreshToken": "*******"
}
错误码
|
Http状态码 |
错误码 |
错误描述 |
说明 |
|---|---|---|---|
|
400 |
100247 |
Operation not allowed. The application has been frozen. |
应用冻结。 处理建议：请检查应用是否因为欠费冻结。 |
|
400 |
102202 |
Required Parameter is null or empty. |
必选参数为空。 处理建议：请检查请求参数中的必选参数是否已填写。 |
|
401 |
100208 |
AppId or secret is not right. |
appId或secret错误。 处理建议：
|
|
500 |
50252 |
Internal server error. |
服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 |
