简要描述:

  • 获取本企业已上传客户列表

接口版本:

版本号 制定人 制定日期 修订日期
0.0.1 宋德美 2024-06-11

请求URL:

测试环境

  • https://[天象云企业代码].third-test.suxuantech.com/guangying/client/getBabyByMobile

正式环境

  • https://[天象云企业代码].third.suxuantech.com/guangying/client/getBabyByMobile

其中[天象云企业代码] 为客户在天象云注册的企业代码,也是客户天象云登录地址前缀

请求方式:

  • POST

请求头:

参数名 是否必须 类型 说明
Content-Type string 请求类型:application/x-www-form-urlencoded
Token string 请求内容签名、登录时返回

请求参数:

参数名 是否必须 类型 说明
mobile string 用户手机号
baby_name string 宝宝姓名
nickname int 宝宝呢称
keyword date 关键词,在手机号,宝宝姓名和宝宝呢称三个或的关系
birthday_start string 宝宝生日,格式:2024-01-01
birthday_end int 宝宝生日,格式:2024-01-01

返回示例:

正确时返回:

{
    "code": 200,
    "data": [
        {
            "user_id": 1,
            "mobile": "13611111111",
            "name": null,
            "baby_name": null,
            "nickname": "淇淇",
            "birthday": "2010-09-18 00:00:00",
            "gender": "女",
            "baby_id": 30,
            "relation": "爸爸",
            "family_id": "15",
            "photo_sum": 0,
            "upload_count": 0
        },
        {
            "user_id": 116,
            "mobile": "18511111111",
            "name": null,
            "baby_name": null,
            "nickname": "淇淇",
            "birthday": null,
            "gender": null,
            "baby_id": 43,
            "relation": "爸爸",
            "family_id": "16",
            "photo_sum": 0,
            "upload_count": 0
        }
    ],
    "sql": ""
}

错误时返回:

{
    "code": 500,
    "msg": "invalid appid"
}

返回参数说明:

参数名 类型 说明
code int 200为成功,其他为失败
msg string 如果错误,则为错误的具体信息
data array 结果列表
data.user_id int 用户ID
data. mobile string 用户手机号
data. name string 客户姓名
data. baby_name string 上传时用到的配置
data.nickname string 宝宝呢称
data.birthday string 宝宝生日
data.gender string 宝宝性别
data.baby_id string 宝宝id
data.relation string 当前人的关系
data.family_id string 家庭id,一个用户只会有一个主家庭,但可以加入到其他家庭里,也会有多个宝宝
data.photo_sum string 客户所有上传的照片总数量
data.upload_count string 客户上传了多少次

备注:

如果什么也不传,或查询的范围过大,则只会返回前3000条
作者:宋德美  创建时间:2024-06-11 17:05
最后编辑:宋德美  更新时间:2024-12-08 14:43