获取用户信息接口

基本信息

接口描述： 查询指定应用下用户的详细信息，包括用户基础信息、地理位置和用户组等。

接口地址： https://api.chinadlrs.com/developer/profile.php

请求方式： POST

响应格式： JSON

需要开放授权登录

此接口功能基于开放授权登录，所有操作都需要先获取有效的 access_token （或老版本登录接口的 user_token）
具体的获取流程请参考《GAS 开放授权登录接口说明文档》

请求参数

请求头 (Headers)

参数名	类型	必填	描述
Content-Type	string	是	必须设置为 `application/json`

查询参数 (Query Parameters)

参数名	类型	必填	描述	默认值
lang	string	否	响应语言（zh/en）	`zh`

查询参数

查询参数通过在接口地址后直接拼接的方式传递，地址和参数之间用 ? 分隔，多个参数之间用 & 连接。

例如响应语言为英文的接口地址为：
https://api.chinadlrs.com/developer/user_info.php?lang=en

请求体 (Body)

参数名	类型	必填	描述	示例
appid	int	是	应用唯一标识符	`1`
email	string	是	用户邮箱地址	`"user@example.com"`
user_token	string	条件必填	老版本用户令牌	`"KzJkpEDPLCWKN/Xb8gNZ/g=="`
access_token	string	条件必填	新版本访问令牌	`"P5h7hs9+TzQXdkMFbcOLMUD87vzz..."`

参数说明

user_token 和 access_token 参数必须二选一，不能同时提供也不能都不提供

数据加密

user_token 和 access_token 参数是经过加密的字符串，用于验证应用权限和保护数据安全
具体的加密算法请参考《数据加密说明文档》

请求示例

老版本登录方式示例

{
  "appid": 1,
  "email": "user@example.com",
  "user_token": "KzJkpEDPLCWKN/Xb8gNZ/g=="
}

新版本OAuth登录方式示例

{
  "appid": 1,
  "email": "user@example.com", 
  "access_token": "P5h7hs9+TzQXdkMFbcOLMUD87vzzHtDumAakOxOhnss="
}

响应参数

响应参数表

参数名	类型	描述	示例
code	number	状态码	`200`
data	object	用户数据对象
data.uid	string	用户唯一标识符	`"12345"`
data.nickname	string	用户昵称	`"张三"`
data.avatar	string	用户头像URL	`"https://example.com/avatar.jpg"`
data.location	string	用户所在国家代码（基于IP）	`"CN"`
data.user_group	string	用户组别信息，逗号分隔	`"2,4"`
msg	string	响应消息	`"操作成功"`

用户组

开发者可在运营管理平台管理应用的用户组，包括白名单、黑名单、自定义用户组
user_group 字段返回用户在当前应用下的用户组信息，多个组别用逗号分隔
用户组对应关系：

0：白名单用户（内部测试人员）
1：黑名单用户
其他数值：自定义用户组

成功响应示例

{
  "code": 200,
  "data": {
    "uid": "12345",
    "nickname": "张三",
    "avatar": "https://example.com/avatar.jpg",
    "location": "CN",
    "user_group": "2,4"
  },
  "msg": "操作成功"
}

错误响应示例

{
  "code": 401,
  "data": null,
  "msg": "登录已失效"
}

状态码说明

状态码	描述	解决方案
200	操作成功，登录状态有效
400	请求参数缺失	检查 appid 和 email 参数是否提供
400	参数格式错误	检查 user_token 和 access_token 参数是否符合规则（二选一）
404	应用不存在	验证 appid 是否正确
401	Token验证失败	检查 token 是否正确
401	登录已失效	重新登录获取新的 token
500	服务器内部错误	联系系统管理员

基本信息​

请求参数​

请求头 (Headers)​

查询参数 (Query Parameters)​

请求体 (Body)​

请求示例​

响应参数​

状态码说明​