简要描述:
- 获取本企业已上传客户列表
接口版本:
版本号 | 制定人 | 制定日期 | 修订日期 |
---|---|---|---|
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
最后编辑:宋德美 更新时间:2024-12-08 14:43