我们在前面的教程里面介绍了帖子内容以及跟帖内容的获取，这些内容的获取都不需要用户权限，可以直接获得。但是如果我们要实现发帖、跟帖、修改之类的操作的话，就需要用户权限。这一篇我们来介绍怎么通过API实现用户登录。

请求方式：POST

请求地址：http://域名/api

请求数据：

{
	"data": [
		{
			"type": "login",
			"id": "0",
			"attributes": {
				"username": "用户名",
				"password": "密码"
			}
		}
	]
}

返回数据：

{
	"data": [
		{
			"type": "token",
			"id": "1",
			"attributes": {
				"nickname": "昵称",
				"avatar": "头像地址",
				"gender": 0,
				"signature": "个人签名",
				"last_login": "最后登录时间",
				"token": "鉴权信息"
			}
		}
	]
}

获得的鉴权信息我们在前面的教程里面介绍过，必须放在请求头Authorization里面。

如果登录失败，那么会返回错误信息：

{
	"errors": [
		{
			"code": "702",
			"title": "Wrong password",
			"detail": "The entered password is incorrect"
		}
	]
}

这里的错误信息，我们示例了密码错误，title指示了错误信息，detail指示了错误的详情。

剑鱼论坛API调用的错误信息返回格式都是一样的。