根据用户ID获取用户的概要信息

优质

小牛编辑

129浏览

2023-12-01

接口说明

根据用户ID获取用户的概要信息
如需调用，请访问开发者文档来查看详细的接口使用说明
该接口仅开放给已获取SDK的开发者

API地址

GET /usercenter/api/userinfo/v1.0.0/getUserGeneralByUid

是否需要登录

是

请求字段说明

参数	类型	请求类型	是否必须	说明
userId	string	query	是	用户ID

响应字段说明

参数	类型	说明
loginName	string	登录账号名
nickName	string	昵称
realName	string	真实姓名
userType	string	用户类型（1：个人用户，2企业用户）
certificatStatus	string	实名认证状态（0：未认证，1：已实名认证，2：认证失败，3：待审核）

响应成功示例

{
  "code": 0,
  "data": {
    "realName": "",
    "orgName": "",
    "nickName": "",
    "certificatStatus": "0",
    "loginName": "test01",
    "photo": null,
    "userType": "1"
  },
  "message": "成功"
}

响应失败示例

{
  "code": 500,
  "message": "未知错误，请及时联系管理人员进行处理"
}

响应接受类型

application/json

响应状态码

HTTP状态码	原因
0	成功
200	OK
401	Unauthorized
403	Forbidden
404	Not Found
10000	token不能为空
10001	token已失效,请重新登录
12013	用户信息不存在
12029	用户ID不能为空
99998	非法请求
99999	服务器异常

示例代码

$.ajax({

    url: '/usercenter/api/userinfo/v1.0.0/getUserGeneralByUid?userId=',

    type: 'GET',

    data: '',

    dataType: 'text',

    cache: false,

    contentType: 'application/json',

    xhrFields: {

        withCredentials: true

    },

    crossDomain: true,

    success:function(data){

        // 成功返回值

    },

    error:function(XMLHttpRequest, textStatus, errorThrown){

    

    }

})