登录获取Token

2026年 5月 20日下午3:36

**简要描述：**

- 用户登录接口，获取Token。服务端若开启了API_Auth，那么其它接口都需要在请求时附带Token才允许访问。

**请求URL：** 
- ` http://serverip:8000/api/login `
 
**请求方式：**
- POST

**BODY参数：**

|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|username |是 |string |用户名 |
|password |是 |string | md5(密码) |

**参数示例**
```
{
 "username": "admin",
 "password": "21232f297a57a5a743894a0e4a801fc3"
}
```

**返回示例**

``` 
{
 "code": 200,
 "error": "",
 "data": {
 "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6ImFkbWluIn0.HiG-CktjEb_KiDNpLIWGZ2shTbpc0MA6s_x3VduS4bA"
 }
}
```

**返回参数说明**

|参数名|类型|说明|
|:----- |:-----|----- |
|token |string |token值 |

**使用Token**
成功获取到Token后，只需要在以后的API调用中，添加一个header键值
-键名：authorization 
-键值 : eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6ImFkbWluIn0.HiG-CktjEb_KiDNpLIWGZ2shTbpc0MA6s_x3VduS4bA

## PHP 获取Token用例
```
<?php

function http_post_json($url, $jsonStr)
{
 $ch = curl_init();
 curl_setopt($ch, CURLOPT_POST, 1);
 curl_setopt($ch, CURLOPT_URL, $url);
 curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonStr);
 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
 curl_setopt($ch, CURLOPT_HTTPHEADER, array(
 'Content-Type: application/json; charset=utf-8',
 'Content-Length: ' . strlen($jsonStr)
 )
 );
 $response = curl_exec($ch);
 $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
 curl_close($ch);
 
 return array($httpCode, $response);
}

$url = "http://192.168.0.2:8000/api/login";
$jsonStr = json_encode(array(
 'username' => 'admin',
 'password' => '21232f297a57a5a743894a0e4a801fc3'
));
$result = http_post_json($url, $jsonStr);
var_dump($result);
```

```
array(2) {
 [0]=>
 int(200)
 [1]=>
 string(151) "{"code":200,"error":"","data":{"token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6ImFkbWluIn0.9aT4ns8pJ3BirWxitWZtgh5LOYvHPF8MvZ6VnTItIck"}}"
}
```

## JS获取Token用例
```
fetch("http://192.168.0.2:8000/api/login", {
headers: {
"Content-Type": "application/json"
},
method: "POST",
body: JSON.stringify({username:"admin",password:"21232f297a57a5a743894a0e4a801fc3"})
})
.then((res) => {
return res.json();
})
.then((data) => {
if (data.code === 200) {
	console.log(data.data.token);
}
})
.catch((e) => {
console.log("Oops, error" + e);
});
```

文档

登录获取Token