获取单人批次客流
GET
/v1/customer-flow-batch/single提供小时级数据。
接口仅支持离线T+1数据。
start_time,end_time区间范围说明:
1.区间最长长度为7天整。
2.is_desc = false/true,范围为 (start_time,end_time]。
3.只查询时间区间范围内的 hour小时 时间戳数据信息。如(2023-01-06 06:22:22,2023-01-06 10:22:22],小时级数据,会查询[2023-01-06 07:00:00,2023-01-06 08:00:00,2023-01-06 09:00:00,2023-01-06 10:00:00]数据。
4.返回区间内存储数据。如果某个小时时间戳信息无,则表示该时间戳数据值为0。
limit说明:
limit必填[1,1000]。该接口全量返回(start_time,end_time]内的所有批次客流信息数据(最多7*24=168条数据),无分页。
请求参数
Query 参数
company_id
string
公司ID,必填
shop_id
string
店铺ID,选填
start_time
string
必需
开始时间 10位时间戳,必填
end_time
string
必需
结束时间 10位时间戳,必填
limit
integer
必需
单次拉取数据量,不超过MAX(1000),必填
is_desc
string
可选
是否按照时间倒序, 非必填,默认false,计算sign时需要加上该参数
示例值:
bool值,false/true
cursor
string
可选
分页专用的参数, 第一次请求不传; 当数据量超过MAX时,需传入上一次请求返回值
open_status
string
门店开放状态筛选
示例值:
"open"仅开放店铺,"close"仅关闭店铺,"":全部状态店铺
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
code
string
错误码
10000正常 ;非10000不正常
msg
string
返回消息
data
object
可选
list
array [object {2}]
可选
next_cursor
string
分页专用
示例
{
"code": "10000",
"msg": "success",
"data": {
"list": [
{
"time_to_hour": 1672534800,
"value": 1
},
{
"time_to_hour": 1672542000,
"value": 2
},
{
"time_to_hour": 1672545600,
"value": 1
},
{
"time_to_hour": 1672549200,
"value": 1
},
{
"time_to_hour": 1672552800,
"value": 4
},
{
"time_to_hour": 1672556400,
"value": 1
},
{
"time_to_hour": 1672560000,
"value": 3
},
{
"time_to_hour": 1672563600,
"value": 1
},
{
"time_to_hour": 1672567200,
"value": 2
},
{
"time_to_hour": 1672570800,
"value": 2
}
],
"next_cursor": "1672574400"
}
}
修改于 1 年前