账号服务-阿里云帮助中心

提供一组与用户账号体系相关的服务接口，通过本组服务接口可以实现用户账户信息的查询和设置。

注销账号
根据登录状态获取当前用户的详细信息
获取用户上传头像的URL及加密签名

注销账号

定义描述

path	版本	描述	是否需要用户身份的鉴权
account/unregister	1.0.6	账号注销	是，客户端SDK需启用身份的鉴权，进行身份认证

请求参数

无业务请求参数

返回参数

无业务返回参数

示例

请求示例

{
     "id":1508232047196,
      "request": {
        "iotToken": "109049cxxxxxxxxb15f6f62e29a3ba",
        "apiVer": "1.0.6"
      },
      "params": {
       },
      "version": "1.0"
}

正常返回示例

{
  "code": 200,
  "message": "success",
  "localizedMsg": null,
  "class": "com.aliyun.iotx.common.base.service.IoTxResult"
}

根据登录态获取当前用户的详细信息

定义描述

path	版本	描述	是否需要用户身份的鉴权
/user/account/session/authidentity	1.0.1	根据登录态获取当前用户的详细信息	是，客户端SDK需启用身份的鉴权，进行身份认证

请求参数

参数	类型	必填	描述
iotToken	String	是	用户登录态

返回参数

名称	类型	描述
companyId	String	公司ID
companyName	String	公司名
identityId	String	统一身份ID
loginName	String	登录名
nickName	String	昵称
phone	String	手机号
email	String	邮箱地址

示例

请求示例

{
     "id":1508232047194,
      "request": {
        "apiVer": "1.0.1"
      },
      "params": {
        "request": {
          "iotToken": "xxxxxxxxxxxxx",
        }
      },
      "version": "1.0"
}

正常返回示例

{
  "id": "8d1a665e-ce92-xxxx-xxxx-99d2e81814f3",
  "code": 200,
  "message": null,
  "localizedMsg": null,
  "data": {
    "companyId": "95BDDAxxxxxxxxt8240A19D5",
    "companyName": "test物联技术有限公司",
    "identityId": "5022al4d34xxxxxxxxaf3fac06085",
    "loginName": "test物联",
    "nickName": "test物联",
    "phone": "xxxxxxxxxxx",
    "email": "a***@example.net"
  }
}

获取用户上传头像的URL及加密签名

当用户需要修改头像时流程如下。

调用此接口获取上传的URL和签名等参数。
App取得上传的URL和签名等参数后，通过POST方法将头像上传（请参见PostObject）。
上传时header中的x-oss-forbid-overwrite参数不能设置为true，否则可能导致上传失败。上传成功后，根据流程1中调用接口的返回参数中的host、dir拼接得出头像图片URL地址（拼接规则为“https://”+ host + “/” + dir）。
通过修改账号属性接口更新图像URL。

path	版本	描述	是否需要用户身份的鉴权
/living/user/avatar/upload/signature/get	1.0.0	用户头像上传URL以及加密签名获取	是，客户端SDK需启用身份的鉴权，进行身份认证

请求参数

参数	类型	必填	描述
fileSize	int	是	头像图片文件大小，单位为字节，取值范围最小为1；最大为10485760（10M）。

返回参数

名称	类型	描述
accessKey	String	OSS的accessKey
dir	String	图片在OSS桶里的存储目录
expire	Long	过期时间戳，毫秒为单位，在此时间戳之前可以向OSS上传头像
host	String	OSS访问域名地址
signature	String	签名
policy	String	请求表单域的合法性校验信息

示例

请求示例

{
     "id":1508232047194,
      "request": {
        "apiVer": "1.0.0"
      },
      "params": {
        "request": {
          "fileSize": 300888
        }
      },
      "version": "1.0"
}

正常返回示例

{
    "id":1508232047194,
    "code":200,
    "data": {
        "signature":"b45CXXXXXXXXXXXXXXXXXXXXXX",
        "accessKey":"LTAXXXXXXXXXXXXX",
        "expire":1578077777777,
        "host":"xxxx.oss-ap-shanghai.aliyuncs.com",
        "dir":"images/third_app_user/profile/50adopbXXXXXX_MmI2NGJjZD.png",
        "policy":"eyJleHBpcmFXXXXXXXXXXX0aW9uIjoiMjAy"
       }
}