device-docking/爱牵挂/爱牵挂M1对外API/community.md

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

社区信息

查看社区信息

• 地址: /api/community/[community id]

• 方法: GET

• 验证方法: Cookie: user

• 权限要求: superuser/operator角色 或 社区成员

• 响应对象: Community

• 请求范例

  curl -v -A CURL -b cookies.txt http://127.0.0.1:8000/api/community/54a38233bf483c6ddfec4b79
  

• 响应范例

{ "obj":{ "_id":{ "$oid":"54a38233bf483c6ddfec4b79" }, "name":"测试社区", "email":"test@test.com", "telephone":"13399999999", "administrators":[ { "$oid":"53f722d5bf483c5bd03d0a80" } ], "sos_url":"http://test.aiqiangua.com/12349xzOrgan/api/sos/happenSOSAction.do?", "location_url":"", "sosdata_url":"", "heartratedata_url":"", "pedometerdata_url":"", "sleepdata_url":"", "powerdata_url":"", "falldata_url":"", "token":"", "created_at":{ "$date":1420030643432 }, "$administrators":[ { "_id":{ "$oid":"53f722d5bf483c5bd03d0a80" }, "username":"user01", "password":"d5a99288b270b6c1989975fdb352425913c45e1640b35473ef9370fc", "email":"user01@abc.com", "nickname":"管理员", "phone":"12345612349", "telephone":"020-183849339", "app":"aiqiangua2.0", "devicetokens":[

            ],
            "weight":65,
            "step":60,
            "age":50,
            "height":175,
            "avatar":"user01.tmp",
            "avatar_url":"/media/avatar/200/user01.jpg",
            "community":{
                "$oid":"54a38233bf483c6ddfec4b79"
            },
            "role":"user",
            "gender":"male",
            "address":"广州",
            "created_at":{
                "$date":1408734037917
            },
            "updated_at":{
                "$date":1408734037913
            },
            "lastlogin_ip":"183.61.80.249",
            "lastlogin_at":{
                "$date":1473846870019
            },
            "lastlogin_by":"Java/1.6.0_25",
            "enable":true,
            "email_is_checked":false,
            "phone_is_checked":false,
            "push_sos_enable":false,
            "push_fence_enable":false,
            "push_abnormal_enable":false,
            "push_message_enable":false,
            "push_lowpower_enable":false,
            "push_system_enable":false,
            "push_fall_enable":true,
            "push_env_enable":true,
            "auth_updated_at":{
                "$date":1473846882861
            },
            "is_device_owner":false,
            "devices":[
                "868219000223161"
            ],
            "groups":[
                {
                    "$oid":"579e0267264251061974b349"
                }
            ]
        }
    ]
},
"success":true,
"obj_name":"community"

}

查看社区内所有设备设备号，昵称，在线状态、地址以及位置点

• 地址: /api/community/community id/devicesloc/

• 方法: GET

• 验证方法: Cookie: user

• 响应对象: 返回单个对象，如果对应的数据项有数据，则返回数据对象；如果没有则返回'{}'

• 权限要求: superuser/operator角色 或 社区成员

• 响应对象: Community

• URL参数: device oid

• 请求参数:

  名称	必须	类型	说明
  cid	是	string	机构id

• 请求范例:

  curl -v -A CURL -b cookies.txt http://127.0.0.1:8888/api/community/59718dfa264251292a48b5c2/devicesloc/
  
  > GET /api/community/59718dfa264251292a48b5c2/devicesloc/ HTTP/1.1
  > User-Agent: CURL
  > Host: 127.0.0.1:8888
  > Accept: */*
  > Cookie: ""2|1:0|10:1502846059|4:user|8:YWRtaW4y|f92dad6929734b005ea153a4585f3c02ea9f7a70432a0410518df8a108030f7d""
  

• 响应范例:

  { "objs": [ { "point": { "type": "Point", "coordinates": [ 113.4560004, 23.1663146 ] }, "online": true, "date": { "$date": 1502901949303 }, "address": "广东省 广州市 黄埔区 育星路 靠近广州科学城创新大厦C2", "imei": "869426020070147", "nickname": "二踢脚" } ], "page": "", "success": true, "obj_name": "devices_location" }