ECJiaWiki:UCenterApi:user/login

来自ECJiaWiki
跳到导航 跳到搜索

应用场景

 用户登录

接口名称

 user/login

Body请求参数

字段名 变量名 必填 示例值 描述
模块 m user 模块
控制器 c login 控制器
固定参数 inajax 2 固定参数
API版本日期 release 20170101 API版本日期
应用ID appid 1 应用ID

接口描述

 本接口函数用于用户的登录验证,用户名及密码正确无误则返回用户在到家的基本数据,否则返回相应的错误信息。如果应用程序是升级过来的,并且当前登录用户和已有用户重名,那么返回的数组中 [4] 的值将返回 1。

请求参数

字段名 变量名 必填 类型 示例值 描述
用户名 username string ecjia 用户名 / 用户 ID
密码 password string 密码
是否使用用户ID登录 isuid bool 是否使用用户ID登录,现已经扩展为多种类型登录方式;
  • 0:(默认值)使用用户名登录
  • 1:使用用户ID登录;
  • 2:使用邮箱登录
  • 6:使用手机号登录
是否验证安装提问 checkques bool 是否验证安装提问;
  • 1:验证安全提问;
  • 0:(默认值)不验证安全提问
电子邮件 questionid integer 安全提问索引
安全提问答案 answer string 安全提问答案

举例如下

list($uid, $username, $password, $email) = uc_user_login($_POST['username'], $_POST['password']);

if($uid > 0) {
	echo '登录成功';
} elseif($uid == -1) {
	echo '用户不存在,或者被删除';
} elseif($uid == -2) {
	echo '密码错';
} else {
	echo '未定义';
}

返回值

含义

array

integer
  • 大于 0:返回用户 ID,表示用户登录成功
  •       -1:用户不存在,或者被删除
  •       -2:密码错
  •       -3:安全提问错
string 用户名
string 密码
string Email
bool 用户名是否重名