如果是post请求，把参数带到body里面，禁止写到URL后面。URL后面带参数的全是get请求。  （我们的测试服虽然get和post请求都可以使用，但是要是用规范，改post请求的时候必须post请求，并且把参数放到body下，不要放到URL后面。我们的正式服因为换过架构所以会更加规范，修改接口必须是post且放到body下进行请求）

身份验证
========


# 登录

-   地址: /api/auth/login
-   方法: POST
-   响应对象: [person](./object.md#person) *简化*
-   请求参数:

    | 名称         | 必须 | 类型         | 说明                           |
    | ------------ | ---- | ------------ | ------------------------------ |
    | username     |  是  | string       |  填用户名或手机号              |
    | password     |  是  | string       |  填用户密码或短信密码          |
 
  

-   请求范例:
    
        curl -v -A CURL -d "username=demo&password=admin" -c cookies.txt http://127.0.0.1:8888/api/auth/login

-   响应Cookie:
    
        Set-Cookie: user="2|1:0|10:1407508841|4:user|8:YWRtaW4=|19bf2a8edd510eca173cecff546c446e3d800ae34ca3649ec56a566d2386e0de"; expires=Sun, 07 Sep 2014 14:40:41 GMT; Path=/

-   响应范例:  
{
    "obj": {
        "_id": {
            "$oid": "5bda53d2264251367f5a4385"
        },
        "username": "18838030850",
        "nickname": "伟东",
        "phone": "18838030850",
        "devicetokens": [
            {
                "token_type": "android",
                "token": "1a0018970a2e98b8f46",
                "push_server": "jiguang",
                "app": "aiqiangua2.0",
                "is_enable_aliase": false,
                "created_at": {
                    "$date": 1596816909955
                }
            },
            {
                "token_type": "android",
                "token": "100d8559094809f80ca",
                "push_server": "jiguang",
                "uuid": "aiqiangua2.0|74ef4ed806e282ac",
                "app": "aiqiangua2.0",
                "brand": "motorola",
                "phone_type": "xt1079",
                "system_version": "21",
                "is_enable_aliase": false,
                "created_at": {
                    "$date": 1599846173229
                }
            },
            {
                "token_type": "ios",
                "token": "191e35f7e029c78a600",
                "push_server": "jiguang",
                "uuid": "aiqiangua2.0|DBB4C34C-46F1-407C-B0B4-265FB438E3CF",
                "app": "aiqiangua2.0",
                "brand": "apple",
                "phone_type": "iPhone12,5",
                "system_version": "13.6.1",
                "is_enable_aliase": false,
                "created_at": {
                    "$date": 1603189431007
                }
            },
            {
                "token_type": "ios",
                "token": "121c83f7604cef30bbb",
                "push_server": "jiguang",
                "uuid": "aiqiangua2.0|8F945CF7-31E5-4631-A93C-8B1A8F867C37",
                "app": "aiqiangua2.0",
                "brand": "apple",
                "phone_type": "iPhone 5c (GSM)",
                "system_version": "10.3.3",
                "is_enable_aliase": false,
                "created_at": {
                    "$date": 1603290768443
                }
            }
        ],
        "weight": 80,
        "height": 166,
        "birthday": "2006-11-01",
        "avatar": "18838030850.png",
        "avatar_url": "/media/avatar/200/18838030850.jpg",
        "community": {
            "$oid": "5bed061726425171d55ab8a7"
        },
        "gender": "male",
        "address": "科学城",
        "location_enable": true,
        "care_code": "32434385",
        "devices": [],
        "groups": [
            {
                "$oid": "5dc3cc002642513d1356da38"
            },
            {
                "$oid": "5bdc212e26425136804939f0"
            },
            {
                "$oid": "5cd902d626425177be24be3e"
            },
            {
                "$oid": "5d52182c264251738f99f4ef"
            },
            {
                "$oid": "5dcbc4e92642513d1356db10"
            },
            {
                "$oid": "5f584f4c2642511f21c77c9f"
            },
            {
                "$oid": "5f12c3762642517d70510f7d"
            },
            {
                "$oid": "5f8eae282642510b4bd152f2"
            }
        ],
        "bluetoothdevices": [],
        "sleepdevices": [
            "d069e6fae982"
        ]
    },
    "success": true,
    "obj_name": "person"
}