典型场景

第三方应用通过鉴权接口获取到的accessToken是有有效时间的，在accessToken快过期时，通过调用此接口，获取新的accessToken。

接口功能

在accessToken到期前，从物联网平台获取新的accessToken。

接口描述

  1. Auth::login($Authorization);

接口所属类

  1. iotyun\huaweiiot\Auth;

参数说明

  1. $Authorization = array(
  2.   'platformIp' => '平台IP或者域名',
  3.   'platformPort' => '平台端口',
  4.   'appId' => '应用appId',
  5.   'secret' => '应用secret',
  6.     'refreshToken' => '你系统存储的refreshToken'
  7. );
参数 必选/可选 类型 描述
platformIp 必选 String(256) 物联网平台的IP或者域名。
platformPort 必选 String(256) 物联网平台的端口。
appId 必选 String(256) 访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。
secret 必选 String(256) 访问物联网平台的应用密钥，与appId对应，在物联网平台创建应用时由平台分配获得。
refreshToken 必选 String(256) 刷新token，用来获取一个新的accessToken。refreshToken在调用鉴权接口或刷新token接口时获得。

返回值

AuthRefreshOutDTO

参数 类型 描述
scope String(256) 申请的权限范围，参数值固定为default。
tokenType String(256) 鉴权token的类型，参数值固定为bearer。
expiresIn Integer(256) 平台生成并返回accessToken的有效时间，单位为秒。
accessToken String(256) 鉴权参数，访问物联网平台API接口的凭证。
refreshToken String(256) 鉴权参数，用来刷新accessToken，refreshToken的有效时间为1个月。

错误码

Http状态码 错误码 错误描述 说明
400 100247 Operation not allowed. The application has been frozen. 应用冻结。
处理建议：请检查应用是否因为欠费冻结。
400 102202 Required Parameter is null or empty. 必选参数为空。
处理建议：请检查请求参数中的必选参数是否已填写。
400 50400 The input is invalid. 输入参数无效。
处理建议：请检查接口调用请求中携带参数的合法性。
401 100208 AppId or secret is not right. appId、secret或refreshToken错误。
处理建议：
- 请检查appId、secret、refreshToken是否有误，是否新增字符或缺少字符。
- 请检查请求路径中的IP地址是否有误。
500 50252 Internal server error. 服务器运行内部错误。
处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。