为什么写接口文档，好处是什么？

答：方便日后项目上线，直接把接口文档甩给前端，让前端访问指定的接口地址，得到对应的json数据

格式如下：

好客租房前端接口 v1.0

公共资源

账号申请

接口域名

// 接口地址
https://www.xmmc.com/api/v1

一、用户登录

uri

https://www.xmmc.com/api/v1/login

请求方式

下面代码我是用laravel框架举例子的

Route::group(['middleware'=>'auth:api','prefix'=>'v1','namespace'=>'Api'],function (){
    // 接口登录
    Route::post('login','Api\LoginController@login');
});

请求参数（参数说明）

返回值（参数信息）

{
    "expire": 7200,
    "token": "eyJ0eXAiOiJKV"
}

错误码

二、获取用户信息

uri

请求方式

请求参数

返回值

错误码

注：和用户登录接口信息基本相似