查询⽤户家庭列表

更新时间：2024-01-11 05:57:36下载pdf

本文介绍查询⽤户家庭列表的 API。

接口描述

根据用户 ID，查询⽤户所在的家庭列表。

接口地址

GET: /v1.0/users/{uid}/homes

请求参数

参数名	类型	参数位置	是否必填	说明
uid	String	uri	true	用户 ID

返回参数

参数名	类型	说明
result	List	返回结果

result 说明

参数名	类型	说明
home_id	Long	家庭 ID
name	String	家庭名称
lon	Double	经度
lat	Double	纬度
geo_name	String	家庭详细地址
role	String	角色

请求示例

GET: /v1.0/users/ay152896****0qLVPu/homes

返回示例

{
    "tid": "5f9f26317d3811ee82c7664ef4d3e193",
    "result": [
        {
            "role": "OWNER",
            "lon": 120.06379847441336,
            "name": "我的家",
            "home_id": 1600008315,
            "lat": 30.302736025227816,
            "geo_name": "杭州市华策中心A座"
        },
        {
            "role": "OWNER",
            "lon": 0,
            "name": "我的家2",
            "home_id": 165000289,
            "lat": 0,
            "geo_name": ""
        }
    ],
    "t": 1699339157175,
    "success": true
}

错误码

参考错误码。