精准客流

获取精准客流门店列表

接口描述: 获取当前企业下所有的精准客流客流门店信息

接口地址: https://yd.yunding360.com/openapi/accStore/store/allList

版本号：V1

请求方式：GET

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
api-version	版本号	headers	true	String	v1
Authorization	认证授权	headers	true	String	tokenType + accessToken

响应示例:

[
  {
    "storeId": "41833b40-e818-11ea-8518-f18d5e21b428",
    "storeCode": "YD001",
    "storeName": "云盯001号店",
    "address": "望江路01号",
    "businessHoursEnd": "23:59:59",
    "businessHoursStart": "00:00:00",
    "groupName": "安阳市",
    "groupIdsUuid": [
      "a85c4d90-3fb6-11e9-9d1e-d395929c723a",
      "a1a95820-7878-11ea-9d75-39447283023d"
    ],
    "groupIdUuid": "a1a95820-7878-11ea-9d75-39447283023d",
    "latitude": 30.65049934387207,
    "longitude": 104.0780029296875,
    "status": "营业",
    "businessStatus": "IN_BUSINESS",
    "city": "成都市",
    "province": "四川省",
    "area": 765.0,
    "storeTags": [
      {
        "id": "",
        "name": ""
      }
    ],
    "storeCategory": [
      {
        "id": "",
        "name": ""
      }
    ],
    "createdTime": 1740467054327,
    "launchTime": 1740467054327,
    "type": "一级经销商"
  }
]

响应参数

参数名称	参数说明	类型	schema
storeId	门店id	uuid
storeCode	门店编号	String
storeName	门店名称	String
address	门店地址	String
type	门店类型	String
businessHoursEnd	结束营业时间	String
businessHoursStart	开始营业时间	String
groupName	所属分组名称	String
groupIdsUuid	所属分组ids	List
groupIdUuid	所属分组id	uuid
latitude	纬度	Double
longitude	经度	Double
status	营业状态名称, 营业 关闭 暂停	String
businessStatus	营业状态, IN_BUSINESS(运行) CLOSING(关闭) SUSPEND(暂停)	String
city	城市	String
province	省份	String
area	面积	Double
storeTags	门店标签	array	StoreTag
storeCategory	门店类别	array	StoreTag
launchTime	上线时间	integer(int64)
createdTime	创建时间	integer(int64)

StoreTag

参数名称	参数说明	类型	schema
id	Id	string(uuid)
name	名称	string

响应状态:

状态码	说明	schema
200	OK	门店列表信息

获取客流数据及时长数据

接口描述 通过门店id或者区域id获取精准客流顾客数及平均停留时长

接口地址 https://yd.yunding360.com/openapi/accStore/getAvgTimeAndFlowNum

版本号 V2

请求方式 POST

请求参数

参数名称	参数说明	in	是否必须	数据类型	选填
api-version	版本号	headers	true	String	v2
Authorization	认证授权	headers	true	String	tokenType + accessToken
storeIds	门店id	body	false	uuid	storeIds/groupId只选一个
startTime	开始时间	body	true	String	格式：yyyy-MM-dd
endTime	结束时间	body	true	String	格式：yyyy-MM-dd
timeType	时间类型枚举，DAY-天，HOUR-小时	body	true	String
groupId	场所区域id	body	false	uuid	storeIds/groupId只选一个
page	页码	param	true	Integer
size	每页展示个数	param	true	Integer

响应示例

{
  "content": [
    {
      "storeIdUuid": "41833b40-e818-11ea-8518-f18d5e21b4c8",
      "storeCode": "test3",
      "name": "某门店名称",
      "realTime": "2022-12-06",
      "customerPersonNum": 3800,
      "totalCustomerPersonNum": 3600,
      "totalPassTimes": 796,
      "totalWanderTime": "7603800",
      "statDimensionDayTime": "20221206",
      "statDimensionHourTime": null,
      "avgWanderTime": "2001",
      "indoorTimes": 0,
      "outdoorTimes": 0,
      "processTime": 1681259342000
    }
  ],
  "metadata": {
    "size": 20,
    "totalElements": 30,
    "totalPages": 2,
    "page": 0
  }
}

响应参数

参数名称	参数说明	类型	schema
storeIdUuid	门店场所id	uuid
storeCode	门店编号	String
name	门店名称	String
realTime	格式化数据	String	格式：yyyy-MM-dd
totalPassTimes	过店人次	Integer
indoorTimes	进店人次	Integer
outdoorTimes	出店人次	Integer
totalCustomerPersonNum	全量顾客数	Integer
customerPersonNum	顾客数	Integer
totalWanderTime	顾客游逛总时长	String	单位(秒)
avgWanderTime	顾客平均停留时长	String	单位(秒)
statDimensionDayTime	数据库中的天时间	String	格式: yyyyMMdd
statDimensionHourTime	数据库中的小时时间	String	格式: yyyyMMddHH
processTime	数据最后处理时间	Long

响应状态:

状态码	说明	schema
200	OK	获取精准客流数据及时长数据V2

获取顾客区域关注度数据

接口描述 通过门店id或者区域id获取店铺以及店内分区的关注客流和时长

接口地址 https://yd.yunding360.com/openapi/accStore/getAttentionIndex

版本号 V1

请求方式 POST

请求参数

参数名称	参数说明	in	是否必须	数据类型	备注
api-version	版本号	headers	true	String	v1
Authorization	认证授权	headers	true	String	tokenType + accessToken
storeIds	门店id	body	false	List	storeIds/groupId只选一个
groupId	场所区域id	body	false	uuid	storeIds/groupId只选一个
startTime	数据开始时间	body	true	String	格式：yyyy-MM-dd
endTime	数据结束时间	body	true	String	格式：yyyy-MM-dd
timeType	时间类型枚举，DAY-天	body	true	String

响应示例

[
  {
    "storeId": "1eae81841833b408518f18d5e21b4c8",
    "storeIdUuid": "41833b40-e818-11ea-8518-f18d5e21b4c8",
    "storeName": "门店1",
    "storeCode": "code1",
    "countDate": "20210101",
    "countDateTime": null,
    "storeAreaResult": [
      {
        "areaId": "3d30d180c30214b9a5e891543dd1d0de",
        "areaName": "区域1",
        "areaTraffic": 11,
        "attentionTraffic": 5,
        "avgStayedtime": 1471
      },
      {
        "areaId": "66616c5aada1670f0930c2368b0fe1e5",
        "areaName": "区域2",
        "areaTraffic": 17,
        "attentionTraffic": 10,
        "avgStayedtime": 418
      }
    ]
  },
  ...
]

响应参数

参数名称	参数说明	类型	schema
storeId	门店id	String	String格式
storeIdUuid	门店id	uuid	UUID格式
storeName	门店名称	String	认证授权
storeCode	门店编号	String
countDate	天日期	String	格式：yyyyMMdd
storeAreaResult	Object	List
--areaId	区域id	uuid
--areaName	区域名称	String
--attentionTraffic	区域关注顾客数	Integer
--avgStayedtime	区域平均关注时长	Integer

响应状态:

状态码	说明	schema
200	OK	获取精准客流区域关注度数据

获取顾客楼层客流数据

接口描述 楼层客流统计数据

接口地址 https://yd.yunding360.com/openapi/customer_flow/floor/count

版本号 v1

请求方式 POST

请求参数

参数名称	参数说明	in	是否必须	数据类型	选填
startTime	开始时间	body	true	long	时间戳:1706076674000
endTime	结束时间	body	true	long	时间戳:1706076674000
groupId	区域id	body	true	string	楼层id和门店id和门店code和区域id三选一
storeIds	门店id	body	true	array	楼层id和门店id和门店code和区域id三选一
storeCodes	门店code	body	true	array	楼层id和门店id和门店code和区域id三选一
floorId	楼层id	body	true	string	楼层id和门店id和门店code和区域id三选一
page	页码	query	true	int
size	每页数量	query	true	int

请求示例

{
  "startTime": 1728662400000,
  "endTime": 1731254399999,
  "timeType": "DAY",
  "groupId": "822f8f90-a452-11ea-a0cb-2f3412c3f239"
}

响应参数

参数名称	参数说明	数据类型
id	id	String
storeId	门店id	String
storeName	门店名	String
floorId	楼层id	String
floorName	楼层名	String
storeCustomerNum	门店顾客数	int
floorCustomerNum	当前楼层顾客数	int
downstairsFloorCustomerNum	下层顾客数	int
upstairsCustomerNum	上楼顾客数	int
floorWanderTime	当前楼层游逛时间	int
floorWanderTimeAvg	当前楼层游逛平均时间	int
dayTime	时间	String
floorArriveRate	楼层到达率	float
upstairsRate	上楼率	float
processTime	数据最后处理时间	Long

响应示例

{
  "content": [
    {
      "id": "1ef90496633fd1c91b067295d8df79e_20241022",
      "storeId": "8eb4f720-538d-11ea-a07b-639c87790018",
      "storeName": "aa云盯猫",
      "floorId": "1ef90496633fd1c91b067295d8df79e",
      "floorName": "楼层B2",
      "storeCustomerNum": 343,
      "floorCustomerNum": 441,
      "downstairsFloorCustomerNum": 544,
      "upstairsCustomerNum": 1,
      "floorWanderTime": 6028,
      "floorWanderTimeAvg": 13,
      "dayTime": "20241022",
      "floorArriveRate": 1.2857,
      "upstairsRate": 0.0018,
      "processTime": 1665417600000
    },
    {
      "id": "1ef90493dc33441b922d364736cf7ba_20241022",
      "storeId": "8eb4f720-538d-11ea-a07b-639c87790018",
      "storeName": "aa云盯猫",
      "floorId": "1ef90493dc33441b922d364736cf7ba",
      "floorName": "楼层1",
      "storeCustomerNum": 343,
      "floorCustomerNum": 544,
      "downstairsFloorCustomerNum": 413,
      "upstairsCustomerNum": 4,
      "floorWanderTime": 5512,
      "floorWanderTimeAvg": 10,
      "dayTime": "20241022",
      "floorArriveRate": 1.586,
      "upstairsRate": 0.0097,
      "processTime": 1665417600000
    },
    {
      "id": "1ef904978cc6cc28345bf494683dbc8_20241022",
      "storeId": "8eb4f720-538d-11ea-a07b-639c87790018",
      "storeName": "aa云盯猫",
      "floorId": "1ef904978cc6cc28345bf494683dbc8",
      "floorName": "F3",
      "storeCustomerNum": 343,
      "floorCustomerNum": 413,
      "downstairsFloorCustomerNum": null,
      "upstairsCustomerNum": null,
      "floorWanderTime": 3973,
      "floorWanderTimeAvg": 9,
      "dayTime": "20241022",
      "floorArriveRate": 1.2041,
      "upstairsRate": null,
      "processTime": 1665417600000
    }
  ],
  "metadata": {
    "size": 20,
    "totalElements": 3,
    "totalPages": 1,
    "page": 0
  }
}

获取顾客游逛时长分布数据

接口描述: 获取精准客流顾客游逛时长分布数据

接口地址: https://yd.yunding360.com/openapi/accStore/instore/wander

请求方式：GET

consumes ["application/json"]

版本号 v1

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
Authorization	Oauth2认证令牌	header	false	string
api-version	API版本号, 可用值:v1	header	true	string
groupId	区域id	query	false	string
storeIds	门店id	query	false	array
timeType	统计时间类型，DAY("天"), WEEK("周"), MONTH("月"), QUARTER("季度"), YEAR("年")	query	false	string
businessType	业务类型，BM00019精准客流	query	false	string
currentStartTime	本期开始时间，时间戳（毫秒）	query	false	string
currentEndTime	本期结束时间，时间戳（毫秒）	query	false	string
lastStartTime	上期开始时间，时间戳（毫秒）	query	false	string
lastEndTime	上期结束时间，时间戳（毫秒）	query	false	string
customWanderTypeConfig	是否以自定义等级配置获取数据，true 是，false 否(以默认配置获取)，不传默认为否	query	false	boolean

响应示例:

{
  "wanderTimeLast": [
    {
      "key": "Tk00001",
      "name": "1~30s",
      "value": 47.06
    },
    {
      "key": "Tk00002",
      "name": "31~60s",
      "value": 0
    },
    {
      "key": "Tk00003",
      "name": "1~2min",
      "value": 11.76
    },
    {
      "key": "Tk00004",
      "name": "2~5min",
      "value": 11.76
    },
    {
      "key": "Tk00005",
      "name": "5~10min",
      "value": 5.88
    },
    {
      "key": "Tk00006",
      "name": ">10min",
      "value": 23.54
    }
  ],
  "wanderTimeCurrent": [
    {
      "key": "Tk00001",
      "name": "1~30s",
      "value": 52.94
    },
    {
      "key": "Tk00002",
      "name": "31~60s",
      "value": 5.88
    },
    {
      "key": "Tk00003",
      "name": "1~2min",
      "value": 11.76
    },
    {
      "key": "Tk00004",
      "name": "2~5min",
      "value": 5.88
    },
    {
      "key": "Tk00005",
      "name": "5~10min",
      "value": 0
    },
    {
      "key": "Tk00006",
      "name": ">10min",
      "value": 23.54
    }
  ]
}

响应参数说明:

参数名称	参数说明	类型	schema
wanderTimeCurrent	当前游逛时长数据	array(Object)
--key	游逛时长key	String
--name	游逛时长名称	String
--value	游逛时长值，百分比数据（%）	String
wanderTimeLast	上一周期游逛时长数据	array(Object)
--key	游逛时长key	String
--name	游逛时长名称	String
--value	游逛时长值，百分比数据（%）	String

获取到访顾客组批次数据

接口描述 通过门店id或者区域id获取到访顾客组批次数据

接口地址 https://yd.yunding360.com/openapi/batchflow/detail

版本号 v1

请求方式 POST

请求参数

参数名称	参数说明	in	是否必须	数据类型	备注
api-version	版本号	headers	true	String	v1
Authorization	认证授权	headers	true	String	tokenType + accessToken
storeIds	门店id	body	false	List	storeIds/groupId只选一个
groupId	场所区域id	body	false	uuid	storeIds/groupId只选一个
startTime	数据开始时间	body	true	String	格式：1704038400000
endTime	数据结束时间	body	true	String	格式：1704124799000
timeType	时间类型枚举，HOUR-小时，DAY-天	body	true	String

响应示例

[
  {
    "storeId": "bffe0e55-a691-11ed-b0ff-b7bb6c406837",
    //门店UUID
    "dataTime": "2023-02",
    //timeType为DAY返回天:yyyy-MM-dd(2023-12-28) timeType为HOUR返回小时:HH:00 (06:00)
    "siteName": "成都云盯科技",
    //groupId不为空则是区域名称, groupId为空则是门店名称
    "trafficIn": 0,
    //进店人次
    "customerPersonNum": 144,
    //顾客数
    "batchFlowCount": 142,
    //顾客组
    "batchFlowCountOnce": 140,
    //顾客组游逛时间总和
    "batchFlowWanderTotal": 2311,
    //顾客组平均游逛时间
    "batchFlowWanderAvg": 356.82,
    //1人组
    "batchFlowOnceDetail": //1人组 占比 
    {
      "date": "2023-02",
      //时间
      "name": "1人组",
      //名称
      "male": "68.18",
      //男
      "allMale": "68.18",
      "female": "31.82",
      //女
      "allFemale": "31.82",
      "child": "0.00",
      //小孩
      "allChild": "0.00",
      "juvenile": "0.00",
      //少年
      "allJuvenile": "0.00",
      "youth": "77.27",
      //青年
      "allYouth": "77.27",
      "middleAged": "22.73",
      //中年
      "allMiddleAged": "22.73",
      "oldAge": "0.00",
      //老年
      "allOldAge": "0.00"
    },
    "customerNumTwice": 2,
    //2人组
    "customerNumTwiceDetail": //2人组 占比
    {
      "date": "2023-02",
      "name": "2人组",
      "male": "0.00",
      "allMale": "0.00",
      "female": "0.00",
      "allFemale": "0.00",
      "child": "0.00",
      "allChild": "0.00",
      "juvenile": "0.00",
      "allJuvenile": "0.00",
      "youth": "0.00",
      "allYouth": "0.00",
      "middleAged": "0.00",
      "allMiddleAged": "0.00",
      "oldAge": "0.00",
      "allOldAge": "0.00"
    },
    "customerNumThree": 0,
    //3人组
    "customerNumThreeDetail": null,
    //3人组 占比
    "customerNumThreeUpon": 0,
    //多人组(3人以上)
    "customerNumThreeUponDetail": null
    //多人组(3人以上) 占比
  }
]

响应参数说明:

BatchFlowDetailResult

参数名称	参数说明	类型	备注
storeId	门店UUID	UUID
dataTime	日期	String	timeType为DAY返回天: yyyy-MM-dd(2023-12-28) timeType为HOUR返回小时: HH:00 (06:00)
siteName	场所名称	String	groupId不为空则是区域名称 groupId为空则是门店名称
trafficIn	进店人次	int
customerPersonNum	顾客数	int
batchFlowCount	顾客组	int
batchFlowWanderTotal	顾客组游逛时间总和	int	单位:秒
batchFlowWanderAvg	顾客组平均游逛时间	double
batchFlowCountOnce	1人组	int
batchFlowOnceDetail	1人组 占比	BatchFlowDetail
customerNumTwice	2人组	int
customerNumTwiceDetail	2人组 占比	BatchFlowDetail
customerNumThree	3人组	int
customerNumThreeDetail	3人组 占比	BatchFlowDetail
customerNumThreeUpon	多人组(3人以上)	int
customerNumThreeUponDetail	多人组(3人以上) 占比	BatchFlowDetail

BatchFlowDetail

参数名称	参数说明	类型	备注
date	时间	String
name	名称	String
male	男	String
allMale		double
female	女	double
allFemale		double
child	小孩	double
allChild		double
juvenile	少年	double
allJuvenile		double
youth	青年	double
allYouth		double
middleAged	中年	double
allMiddleAged		double
oldAge	老年	double
allOldAge		double

获取顾客组游逛时长分布数据

接口描述: 获取精准客流顾客组游逛时长分布数据

接口地址: https://yd.yunding360.com/openapi/accStore/batchflow/wander

请求方式：GET

consumes ["application/json"]

版本号 v1

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
Authorization	Oauth2认证令牌	header	false	string
api-version	API版本号, 可用值:v1	header	true	string
groupId	区域id	query	false	string
storeIds	门店id	query	false	array
timeType	统计时间类型，DAY("天"), WEEK("周"), MONTH("月"), QUARTER("季度"), YEAR("年")	query	false	string
businessType	业务类型，BM00019精准客流	query	false	string
currentStartTime	本期开始时间，时间戳（毫秒）	query	false	string
currentEndTime	本期结束时间，时间戳（毫秒）	query	false	string
lastStartTime	上期开始时间，时间戳（毫秒）	query	false	string
lastEndTime	上期结束时间，时间戳（毫秒）	query	false	string
customWanderTypeConfig	是否以自定义等级配置获取数据，true 是，false 否(以默认配置获取)，不传默认为否	query	false	boolean

响应示例:

{
  "wanderTimeLast": [
    {
      "key": "Tk00001",
      "name": "1~30s",
      "value": 47.06
    },
    {
      "key": "Tk00002",
      "name": "31~60s",
      "value": 0
    },
    {
      "key": "Tk00003",
      "name": "1~2min",
      "value": 11.76
    },
    {
      "key": "Tk00004",
      "name": "2~5min",
      "value": 11.76
    },
    {
      "key": "Tk00005",
      "name": "5~10min",
      "value": 5.88
    },
    {
      "key": "Tk00006",
      "name": ">10min",
      "value": 23.54
    }
  ],
  "wanderTimeCurrent": [
    {
      "key": "Tk00001",
      "name": "1~30s",
      "value": 52.94
    },
    {
      "key": "Tk00002",
      "name": "31~60s",
      "value": 5.88
    },
    {
      "key": "Tk00003",
      "name": "1~2min",
      "value": 11.76
    },
    {
      "key": "Tk00004",
      "name": "2~5min",
      "value": 5.88
    },
    {
      "key": "Tk00005",
      "name": "5~10min",
      "value": 0
    },
    {
      "key": "Tk00006",
      "name": ">10min",
      "value": 23.54
    }
  ]
}

响应参数说明:

参数名称	参数说明	类型	schema
wanderTimeCurrent	当前游逛时长数据	array(Object)
--key	游逛时长key	String
--name	游逛时长名称	String
--value	游逛时长值，百分比数据（%）	String
wanderTimeLast	上一周期游逛时长数据	array(Object)
--key	游逛时长key	String
--name	游逛时长名称	String
--value	游逛时长值，百分比数据（%）	String

获取店员服务数据

接口描述 通过门店id或者区域id获取门店店员服务数据

接口地址 https://yd.yunding360.com/openapi/accStore/service/detail

版本号 v1

请求方式 POST

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
Authorization	Oauth2认证令牌	header	false	string
api-version	API版本号, 可用值:v1	header	true	string
startTime	开始时间(毫秒时间戳)	body	true	long	时间戳:1706076674000
endTime	结束时间(毫秒时间戳)	body	true	long	时间戳:1706076674000
groupId	区域id	body	false	string	门店id和区域id二选一
storeId	门店id	body	false	string	门店id和区域id二选一
page	页码	query	true	int
size	每页数量	query	true	int

请求示例

{
  "startTime": 1728662400000,
  "endTime": 1731254399999,
  "groupId": null,
  "storeId": null
}

响应示例:

{
  "content": [
    {
      "date": "2025-03-27",
      "accompanyTimes": 925,
      "receptionCustomerNumber": 949,
      "solicitCustomerLength": 6.52,
      "leaveTimes": 910,
      "leaveLength": 17.2,
      "customerPersonNum": 529,
      "receptionTimeAvg": 0
    }
  ],
  "metadata": {
    "size": 20,
    "totalElements": 1,
    "totalPages": 1,
    "page": 0
  }
}

响应参数说明:

参数名称	参数说明	类型	schema
date	时间(格式：yyyy-MM-dd)	String
customerPersonNum	顾客数	int
accompanyTimes	接待次数	int
solicitCustomerLength	迎宾时长(分钟)	Double
leaveTimes	离岗次数	int
leaveLength	离岗时长(分钟)	Double
receptionCustomerNumber	接待人数	int
receptionTimeAvg	平均接待时长(分钟)	Double

获取试衣间数据

接口描述:

接口地址: https://yd.yunding360.com/openapi/accStore/fitting/allList

请求方式：POST

请求示例：

{
  // "groupId": "AAAA",
  // "storeAreaIds":["xxxx"],
  "storeIds": [
    "DDDD"
  ],
  "startTime": "1704816000000",
  "endTime": "1705420799999"
}

请求参数：

参数名称	in	是否必须	数据类型	参数说明
groupId	body	false	String	区域id(与storeIds,storeAreaIds 3选1)
storeIds	body	false	String[]	门店id数组(与groupId,storeAreaIds 3选1)
storeAreaIds	body	false	String[]	店内区域id数组(与groupId,storeIds 3选1)
startTime	body	true	Long	开始时间(时间戳:1706076674000)
endTime	body	true	Long	结束时间(时间戳:1706076674000)
businessType	body	false	String	业务类型,可不填

schema属性说明

响应参数说明

参数名称	参数说明	数据类型
storeId	门店id	String
storeName	门店名称	String
areaId	区域id	String
areaName	区域名称	String
fittingPersonNum	试衣顾客数	Long
fittingTimes	试衣次数	Long
processTime	数据最后处理时间	Long

响应示例:

[
  {
    "storeId": "8eb4f720-538d-11ea-a07b-639c87790018",
    "storeName": "云盯猫",
    "areaId": "1eeb50a25ffb7bf8cbc75dbb1af21a0",
    "areaName": "试衣间测试001",
    "fittingPersonNum": 3393,
    "fittingTimes": 3929,
    "processTime": 1706076674000
  }
]

获取顾客画像数据

接口描述:

接口地址: https://yd.yunding360.com/openapi/customer/attributes/detail

请求方式：POST

请求示例：

{
  "storeIds": [
    "8eb4f720-538d-11ea-a07b-639c87790018"
  ],
  "startTime": "1704816000000",
  "endTime": "1705420799999"
}

请求参数：

参数名称	in	是否必须	数据类型	参数说明
groupId	body	false	String	区域id(与storeIds 2选1)
storeIds	body	false	String[]	门店id数组(与groupId 2选1)
startTime	body	true	Long	开始时间(时间戳:1706076674000)
endTime	body	true	Long	结束时间(时间戳:1706076674000)
timeType	body	false	String	HOUR:小时,DAY:天 , 默认:DAY(天)
businessType	body	false	String	业务类型,可不填

schema属性说明

响应参数说明

参数名称	参数说明	数据类型
allFemaleAccount	女性顾客占比	String
allMaleAccount	男性顾客占比	String
allMaleNum	男性顾客数量	Double
allFeMaleNum	女性顾客数量	Double
storeName	店铺名称	String
storeId	店铺id	UUID
time	日期	String
processTime	数据最后处理时间	Long
attributesDetailList	年龄占比列表	Object[]

AttributesDetailList | 参数名称 | 参数说明 | 数据类型 | | ------------ | ----------- |-----------| |des| 描述 | String | |personNum| 人数数量 | Double | |personAccount| 人数占比 | String | |maleNum| 男性数量 | Double | |femaleNum| 女性数量 | Double | |maleAccount| 男性占比 | String | |femaleAccount|女性占比 | String |

响应示例:

[
  {
    "allFemaleProportion": "0.5845",
    "allMaleProportion": "0.4155",
    "allMaleNum": 86.0,
    "allFemaleNum": 121.0,
    "storeName": "云盯猫",
    "storeId": "8eb4f720-538d-11ea-a07b-639c87790018",
    "time": "2024-01-10",
    "processTime": 1706076674000,
    "attributesDetailList": [
      {
        "des": "小孩(0~6岁)",
        "personNum": 2.0,
        "personProportion": "0.0097",
        "maleNum": 2.0,
        "femaleNum": 0.0,
        "maleProportion": "0.0097",
        "femaleProportion": "0.0000"
      },
      {
        "des": "少年(7~15岁)",
        "personNum": 1.0,
        "personProportion": "0.0048",
        "maleNum": 1.0,
        "femaleNum": 0.0,
        "maleProportion": "0.0048",
        "femaleProportion": "0.0000"
      },
      {
        "des": "青年(16~35岁)",
        "personNum": 186.0,
        "personProportion": "0.8986",
        "maleNum": 72.0,
        "femaleNum": 114.0,
        "maleProportion": "0.3478",
        "femaleProportion": "0.5507"
      },
      {
        "des": "中年(36~60岁)",
        "personNum": 18.0,
        "personProportion": "0.0870",
        "maleNum": 11.0,
        "femaleNum": 7.0,
        "maleProportion": "0.0531",
        "femaleProportion": "0.0338"
      },
      {
        "des": "老年(61岁以上)",
        "personNum": 0.0,
        "personProportion": "-0.0001",
        "maleNum": 0.0,
        "femaleNum": 0.0,
        "maleProportion": "0.0000",
        "femaleProportion": "0.0000"
      }
    ]
  },
  ......
]

私域会员数据上报

接口描述 上报门店的会员统计数据

接口地址 https://yd.yunding360.com/openapi/member/statistics

版本号 V1

请求方式 POST

请求参数

参数名称	参数说明	in	是否必须	数据类型	选填
storeCode	门店code	body	true	String	门店code
memberAddCount	新增会员数	body	true	int
memberCount	会员总数	body	true	int
memberReturnCount	会员维护数	body	true	int
time	场所区域id	body	true	long	时间戳,长度精确到毫秒,例如:1665417600000

请求示例

[
  {
    "storeCode": "1",
    "memberAddCount": 1,
    "memberCount": 1,
    "memberReturnCount": 1,
    "time": 1665417600000
  },
  {
    "storeCode": "2",
    "memberAddCount": 1,
    "memberCount": 4,
    "memberReturnCount": 2,
    "time": 1665417600000
  }
]

响应参数 ok

响应状态:

状态码	说明	schema
200	OK	私域会员数据上报

获取精准客流店内区域列表

接口描述: 获取门店下精准客流店内区域列表信息

接口地址: https://yd.yunding360.com/openapi/accStore/getStoreAreaList

请求方式：POST

版本号 v1

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
Authorization	Oauth2认证令牌	header	false	string
api-version	API版本号, 可用值:v1	header	true	string
storeId	门店id	body	false	string	门店id

请求示例

{
  "storeId": "a85c4d90-3fb6-11e9-9d1e-d395929c723a"
}

响应示例:

[
  {
    "storeId": "",
    "areaId": "",
    "areaName": "区域名称",
    "areaType": ""
  }
]

响应参数

参数名称	参数说明	类型	schema
storeId	门店id	uuid
areaId	区域id	String
areaName	区域名称	String
areaType	区域类型, 400(区域) 402(揽客区) 403(陪同区) 404(门区) 500(楼层) 600(店中店) 601(试衣间) 700(通道)	String

获取店内分区精准客流数据

接口描述 通过店内区域id获取数据

接口地址 https://yd.yunding360.com/openapi/accStore/instore/customer/flow

版本号 v1

请求方式 POST

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
Authorization	Oauth2认证令牌	header	false	string
api-version	API版本号, 可用值:v1	header	true	string
page	页码	query	true	int
size	每页数量	query	true	int
startTime	开始时间(毫秒时间戳)	body	true	long	时间戳:1706076674000
endTime	结束时间(毫秒时间戳)	body	true	long	时间戳:1706076674000
timeType	时间类型枚举，HOUR-小时，DAY-天	body	true	string	HOUR的时候只能传一天
areaIds	店内分区ids	body	false	array

请求示例

{
  "startTime": 1728662400000,
  "endTime": 1731254399999,
  "areaIds": [],
  "timeType": "DAY"
}

响应示例:

{
  "content": [
    {
      "date": "2025-03-27",
      "totalPassTimes": 0,
      "indoorTimes": 0,
      "customerPersonNum": 0,
      "avgWanderTime": 10,
      "fittingPersonNum": 0,
      "fittingTimes": 0,
      "fittingRate": 0.7543,
      "fittingDepth": 0.9635
    }
  ],
  "metadata": {
    "size": 20,
    "totalElements": 1,
    "totalPages": 1,
    "page": 0
  }
}

响应参数说明:

参数名称	参数说明	类型	schema
date	时间(格式：yyyy-MM-dd, HH:mm)	String
totalPassTimes	过店客流	int
indoorTimes	进店客流	int
customerPersonNum	顾客数	int
avgWanderTime	顾客平均停留时长(秒)	Double
fittingPersonNum	试衣人数	int
fittingTimes	试衣次数	int
fittingRate	试衣率	Double
fittingDepth	试衣深度	Double