网络引流系统前后端数据交互接口设计

网络引流系统采用前后端完全解耦的方式进行写作开发，前端主要责任是实现跟用户之间的界面交互，后台的主要责任是进行业务逻辑的处理及业务数据的持久化，前后端通过http协议进行数据交互实现系统的整体联动。

根据用户交互界面，前后端交互接口如下：

注：接口引用中base_url为系统项目管理平台的部署入口URL。

登录

接口URL：base_url/login

交互方式：POST JSON

交互参数：单层JSON格式

响应数据格式：JSON

{

‘flg’:x, //状态，0：登录失败；1：成功

‘msg’:’xxxxxx’, //消息，失败原因，用户名密码错误或者是系统内部错误

‘username’:’xxxxxx’ //登录用户名

}

退出

接口URL：base_url/logout

交互方式：HTTP GET

交互参数：无

响应数据格式：JSON

{

‘flg’:x, //状态，0：登录失败；1：成功

‘msg’:’xxxxxx’ //消息，失败原因，用户名密码错误或者是系统内部错误

}

加载渠道列表

接口URL:base_url/channel/list

交互方式：POST JSON

交互参数：单层JSON格式

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{渠道数据}] //渠道数据列表，如失败或者未登录，则不需要响应此数据

}

注：渠道数据中，需要一个额外的字段，创建人名称，此字段数据来源于用户表，前端可排序字段：名称、创建时间、状态

1 编辑渠道

接口URL:base_url/channel/edit

交互方式：POST JSON

交互参数：复杂JSON格式

{

‘id’:xxxx, //ID，新增渠道时，ID为空

‘code’:xxxx, //代码

‘name’:xxxx, //名称

‘remark’:xxxx, //说明

‘level’:xxxx, //等级

‘feature’:xxxx, //特性

‘state’:xxxx, //状态

‘flag’:xx //操作标志，-1：删除；0：编辑；1：新增

‘props’:[

{

‘id’:xxxxx， //属性ID，新增的属性，ID为空

‘code’:xxxx, //属性代码

‘name’:xxxxx， //属性名称

‘value’:xxxx, //属性值

‘flag’:xx //操作标志，-1：删除；0：编辑；1：新增

}，

…… //其他属性

]

}

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

}

注：渠道特性来源于属性模板表，属性模板表里的类别为“channel_feature_props_tmpl”的属性列表即为渠道特性选项列表。属性那里，如果有模板id的，属性代码不可编辑，如果没有模板id，属性代码可编辑，没有模板id的说明是用户手工添加的属性。另外，有模板id的，如果模板上定义的属性是不可删除的，则这条属性是不能删除的，界面上对应的属性不需要删除按钮及操作，后台也不能删除此属性，如果模板定义的属性是必填的，则这条属性的值不能为空，前端后端就要进行验证。

加载渠道属性

接口URL:base_url/channel/props/{id}

交互方式：RESTFul

交互参数：渠道记录ID，直接包含在URL中,{id}即为渠道记录ID，以get的方式交互

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{渠道属性数据}] //渠道属性数据列表，如失败或者未登录，则不需要响应此数据

}

注：渠道属性数据中，需要额外的字段，可删除、必填，字段数据来源于属性模板表。

属性那里，如果有模板id的，属性代码不可编辑，如果没有模板id，属性代码可编辑，没有模板id的说明是用户手工添加的属性。另外，有模板id的，如果是不可删除的，则这条属性是不能删除的，界面上对应的属性不需要删除按钮及操作，后台也不能删除此属性，如果是必填的，则这条属性的值不能为空，前端后端就要进行验证。渠道属性模板的类别为channel_props_tmpl。

加载渠道营销活动

接口URL:base_url/campaign/list/{id}

交互方式：RESTFul POST JSON

交互参数：渠道记录ID包含在URL中,{id}即为渠道记录ID，单层JSON格式

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{营销活动数据}] //营销活动数据列表，如失败或者未登录，则不需要响应此数据

}

注：营销活动数据字段

前端可排序字段：名称、价格、关键字、创建时间

注：

引流URL=引流系统入口URL+/+引流标识码；

引流系统入口URL通过系统参数配置；

编辑营销活动

接口URL:base_url/campaign/edit

交互方式：POST JSON

交互参数：单层JSON格式

{

‘id’:xxxx, //ID，新增营销活动时，ID为空

‘channel_id’//渠道id

‘keyword’:xxxx, //关键字

‘name’:xxxx, //名称

‘price’:xxxx, //营销活动价格

‘remark’:xxxxx, //营销活动说明

‘cplink_state’:xxxx, //营销活动引流点对应关系状态

‘linkpoint_id’:xxxx, //引流点ID

‘flag’:xx //操作标志，-1：删除；0：编辑；1：新增

}

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’ //消息，失败原因，参数错误或者是系统内部错误

‘link_url’:’xxxxxx’, //引流系统入口ULR

‘link_code’:’xxxxxx’ //引流标识码

}

注：引流标识码=MD5(渠道名称+制表符+营销活动名+制表符+营销活动关键字+制表符+客户名称+制表符+引流点URL)；

引流URL=引流系统入口URL+/+引流标识码；

引流系统入口URL通过系统参数配置；

加载客户列表

接口URL:base_url/customer/list

交互方式：POST JSON

交互参数：单层JSON格式

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{客户数据}] //客户数据列表，如失败或者未登录，则不需要响应此数据

}

注：客户数据中，需要一个额外的字段，创建人名称，此字段数据来源于用户表，前端可排序字段：名称、创建时间、状态

编辑客户

接口URL:base_url/customer/edit

交互方式：POST JSON

交互参数：复杂JSON格式

{

‘id’:xxxx, //ID，新增客户时，ID为空

‘code’:xxxx, //代码

‘name’:xxxx, //名称

‘remark’:xxxx, //说明

‘level’:xxxx, //等级

‘state’:xxxx, //状态

‘flag’:xx //操作标志，-1：删除；0：编辑；1：新增

‘props’:[

{

‘id’:xxxxx， //属性ID，新增的属性，ID为空

‘code’:xxxx, //属性代码

‘name’:xxxxx， //属性名称

‘value’:xxxx, //属性值

‘flag’:xx //操作标志，-1：删除；0：编辑；1：新增

}，

…… //其他属性

]

}

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

}

注：属性那里，如果有模板id的，属性代码不可编辑，如果没有模板id，属性代码可编辑，没有模板id的说明是用户手工添加的属性。另外，有模板id的，如果模板上定义的属性是不可删除的，则这条属性是不能删除的，界面上对应的属性不需要删除按钮及操作，后台也不能删除此属性，如果模板定义的属性是必填的，则这条属性的值不能为空，前端后端就要进行验证。

加载客户属性

接口URL:base_url/customer/props/{id}

交互方式：RESTFul

交互参数：客户记录ID，直接包含在URL中,{id}即为客户记录ID，以get的方式交互

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{客户属性数据}] //客户属性数据列表，如失败或者未登录，则不需要响应此数据

}

注：客户属性数据中，需要额外的字段，可删除、必填，字段数据来源于属性模板表。

属性那里，如果有模板id的，属性代码不可编辑，如果没有模板id，属性代码可编辑，没有模板id的说明是用户手工添加的属性。另外，有模板id的，如果是不可删除的，则这条属性是不能删除的，界面上对应的属性不需要删除按钮及操作，后台也不能删除此属性，如果是必填的，则这条属性的值不能为空，前端后端就要进行验证。客户属性模板的类别为customer_props_tmpl。

客户信息导入

接口URL:base_url/excel/customer_in

交互方式：POST form data

交互参数：excel文件，字段名：excel_file

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；2：有异常；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘success_count’:x, //成功记录数，如失败或者未登录，则不需要响应此数据

‘error_count’:x, //失败记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{客户导入错误数据}] //客户导入错误数据列表，如失败或者未登录，则不需要响应此数据

}

注：lead导入错误数据字段：

注：此接口暂时不用做实现

加载引流点列表

接口URL:base_url/linkpoint/list/{id}

交互方式：RESTFul

交互参数：客户记录ID，直接包含在URL中,{id}即为客户记录ID，以get的方式交互

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{引流点数据}] //引流点数据列表，如失败或者未登录，则不需要响应此数据

}

编辑引流点

接口URL:base_url/linkpoint/edit

交互方式：RESTFul POST JSON

交互参数：单层JSON格式

{

‘id’:xxxx, //ID，新增时，ID为空

‘name’:xxxx, //名称

‘customer_id‘：//客户id

‘url’： //引流点url

‘state’： //状态值

‘remark’： //引流说明

‘flag’:xx //操作标志，-1：删除；0：编辑；1：新增

}

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

}

加载供应商列表

接口URL:base_url/vender/list

交互方式：POST JSON

交互参数：单层JSON格式

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{供应商数据}] //供应商数据列表，如失败或者未登录，则不需要响应此数据

}

注：客户数据中，需要额外的字段，创建人名称，此字段数据来源于用户表，前端可排序字段：名称、创建时间、状态

编辑供应商

接口URL:base_url/vender/edit

交互方式：POST JSON

交互参数：复杂JSON格式

{

‘id’:xxxx, //ID，新增供应商时，ID为空

‘code’:xxxx, //代码

‘name’:xxxx, //名称

‘remark’:xxxx, //说明

‘level’:xxxx, //等级

‘state’:xxxx, //状态

‘flag’:xx //操作标志，-1：删除；0：编辑；1：新增

‘props’:[

{

‘id’:xxxxx， //属性ID，新增的属性，ID为空

‘code’:xxxx, //属性代码

‘name’:xxxxx， //属性名称

‘value’:xxxx, //属性值

‘flag’:xx //操作标志，-1：删除；0：编辑；1：新增

}，

…… //其他属性

]

}

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

}

注：属性那里，如果有模板id的，属性代码不可编辑，如果没有模板id，属性代码可编辑，没有模板id的说明是用户手工添加的属性。另外，有模板id的，如果模板上定义的属性是不可删除的，则这条属性是不能删除的，界面上对应的属性不需要删除按钮及操作，后台也不能删除此属性，如果模板定义的属性是必填的，则这条属性的值不能为空，前端后端就要进行验证。

加载供应商属性

接口URL:base_url/vender/props/{id}

交互方式：RESTFul

交互参数：供应商记录ID，直接包含在URL中,{id}即为供应商记录ID，以get的方式交互

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{供应商属性数据}] //供应商属性数据列表，如失败或者未登录，则不需要响应此数据

}

注：供应商属性数据中，需要额外的字段，可删除、必填，字段数据来源于属性模板表。

属性那里，如果有模板id的，属性代码不可编辑，如果没有模板id，属性代码可编辑，没有模板id的说明是用户手工添加的属性。另外，有模板id的，如果是不可删除的，则这条属性是不能删除的，界面上对应的属性不需要删除按钮及操作，后台也不能删除此属性，如果是必填的，则这条属性的值不能为空，前端后端就要进行验证。客户属性模板的类别为customer_props_tmpl。

供应商信息导入

接口URL:base_url/vender/import

交互方式：POST form data

交互参数：excel文件，字段名：excel_file

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；2：有异常；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘success_count’:x, //成功记录数，如失败或者未登录，则不需要响应此数据

‘error_count’:x, //失败记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{供应商导入数据}] //供应商导入数据列表，如失败或者未登录，则不需要响应此数据

}

注：供应商导入数据字段：

注：此接口暂时不用做实现

加载统计报表列表

接口URL:base_url/report/list

交互方式：http get

交互参数：无

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{报表脚本数据}] //报表脚本数据列表，如失败或者未登录，则不需要响应此数据

}

加载统计结果

接口URL:base_url/report/result/{id}

交互方式：RESTFul

交互参数：报表脚本记录ID，直接包含在URL中,{id}即为报表脚本记录ID，以get的方式交互

交互参数：单层JSON格式

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘titles’:[‘xxxx’,……], //结果集字段数组，如失败或者未登录，则不需要响应此数据

‘items’:[{脚本执行结果数据}] //脚本执行结果数据列表，如失败或者未登录，则不需要响应此数据

}

注：交互参数的分页信息是针对统计脚本的分页信息，也就是在统计脚本的基础上增加分页功能。

titles是查询数据库返回的字段名称组成的数组

编辑统计报表

接口URL:base_url/report/edit

交互方式：POST JSON

交互参数：单层JSON格式

{

‘id’:xxxx, //ID，新增时，ID为空

‘name’:xxxx, //名称

‘script’:xxxx, //统计语句

‘flag’:xx //操作标志，-1：删除；0：编辑；1：新增

}

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

}

加载分析数据列表

接口URL:base_url/lead/list

交互方式：POST JSON

交互参数：单层JSON格式

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{lead数据}] //lead数据列表，如失败或者未登录，则不需要响应此数据

}

注：lead数据字段：

前端展示来源时，如果comefrom为1，则展示渠道名称，为2，则展示渠道名称->营销活动关键字，其他情况来源展示comefrom代码对应的名称（3：客户；4：采购；5人工录入；6：其他），前端可排序字段：姓名、IP、编码、创建时间、注册时间、发送时间、电话、手机、邮箱、级别、来源

注：加载数据的时候，不加载被合并的数据，就是状态为1的不加载

加载分析数据属性

接口URL:base_url/lead/props/{id}

交互方式：RESTFul

交互参数：lead记录ID，直接包含在URL中,{id}即为lead记录ID，以get的方式交互

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{lead属性数据}] //lead属性数据列表，如失败或者未登录，则不需要响应此数据

}

注：lead属性不可编辑，也不可增加，只能查看。

Lead 查重

接口URL:base_url/lead/repeatdetect

交互方式：POST JSON

交互参数：复杂JSON格式

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘repeat_count’:x, //总重复记录数，如失败或者未登录，则不需要响应此数据

‘items’:[lead查重结果数据] //lead查重结果数据，如失败或者未登录，则不需要响应此数据

}

注：lead查重结果数据：

{

‘电话号码’:{

repeat_count : x, //重复记录数，如失败或者未登录，则不需要响应此数据

items : [lead数据]

},

…… //其他电话号码的重复数据

}

lead数据字段：

前端展示来源时，如果comefrom为1，则展示渠道名称，为2，则展示渠道名称->营销活动关键字，其他情况来源展示comefrom代码对应的名称（3：客户；4：采购；5人工录入；6：其他）。

后台查询数据分页处理时总数据量统计的是符合条件的phone去重后的数据量，当前页的数据集也是phone去重后的数据量，比如，每页显示10条记录，则当前页要有10组phone分组的数据集（实际数据量可能超过10条，因为每个IP分组下可能有多条记录——IP相同的记录），后台查询结果排序规则：IP、创建时间（降序）、注册时间（降序）

Lead 查重结果

接口URL:base_url/lead/repeatresult

交互方式：POST JSON

交互参数：复杂JSON格式

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘repeat_count’:x, //符合条件的总重复记录数，如失败或者未登录，则不需要响应此数据

‘items’:[lead查重结果数据] //lead查重结果数据，如失败或者未登录，则不需要响应此数据

}

注：lead查重结果数据：

{

‘电话号码’:{

repeat_count : x, //重复记录数，如失败或者未登录，则不需要响应此数据

items : [lead数据]

},

…… //其他电话号码的重复数据

}

lead数据字段：

前端展示来源时，如果comefrom为1，则展示渠道名称，为2，则展示渠道名称->营销活动关键字，其他情况来源展示comefrom代码对应的名称（3：客户；4：采购；5人工录入；6：其他）。

后台查询数据分页处理时总数据量统计的是符合条件的phone去重后的数据量，当前页的数据集也是phone去重后的数据量，比如，每页显示10条记录，则当前页要有10组phone分组的数据集（实际数据量可能超过10条，因为每个IP分组下可能有多条记录——IP相同的记录），后台查询结果排序规则：IP、创建时间（降序）、注册时间（降序）

Lead 合并记录

接口URL:base_url/lead/mergelog/{id}

交互方式：RESTFul

交互参数：Lead记录ID，直接包含在URL中,{id}即为Lead记录ID，以get的方式交互

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{Lead数据}] //Lead数据列表，如失败或者未登录，则不需要响应此数据

}

lead数据字段：

注：返回的lead数据数组是target_id等于参数上的id的数据数组

Lead合并

接口URL:base_url/lead/merge

交互方式：POST JSON

交互参数：复杂JSON格式

mobiles格式：

[

{

id:xxx, //指定的合并目标Lead记录id

m:xxx //选择的手机号码

}

…… //其他目标

]

查重合并流程

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //符合条件的电话号码数，用于分页，如失败或者未登录，则不需要响应此数据

‘total_count’:x, //合并处理总记录数，如失败或者未登录，则不需要响应此数据

‘success_count’:x, //成功记录数，如失败或者未登录，则不需要响应此数据

‘error_count’:x //失败记录数，如失败或者未登录，则不需要响应此数据

‘items’:[lead合并结果数据] //lead合并结果数据，如失败或者未登录，则不需要响应此数据

}

注：lead合并结果数据：

{

‘电话号码’:{

success_count’:x, //成功记录数，如失败或者未登录，则不需要响应此数据

error_count’:x //失败记录数，如失败或者未登录，则不需要响应此数据

items : [lead数据]

},

…… //其他电话号码的重复数据

}

注：lead数据字段：

前端展示来源时，如果comefrom为1，则展示渠道名称，为2，则展示渠道名称->营销活动关键字，其他情况来源展示comefrom代码对应的名称（3：客户；4：采购；5人工录入；6：其他）。

后台查询数据分页处理时总数据量统计的是符合条件的IP 去重后的数据量，当前页的数据集也是IP去重后的数据量，比如，每页显示10条记录，则当前页要有10组IP分组的数据集（实际数据量可能超过10条，因为每个IP分组下可能有多条记录——IP相同的记录）

此接口分页、查询是针对手机号分组进行分页及条件查询。

Lead合并结果

接口URL:base_url/lead/mergeresult

交互方式：POST JSON

交互参数：复杂JSON格式

mobiles格式：

[

{

id:xxx, //指定的合并目标Lead记录id

m:xxx //选择的手机号码

}

…… //其他目标

]

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //符合条件的电话号码数，用于分页，如失败或者未登录，则不需要响应此数据

‘success_count’:x, //符合条件的成功记录数，如失败或者未登录，则不需要响应此数据

‘error_count’:x //符合条件的失败记录数，如失败或者未登录，则不需要响应此数据

‘items’:[lead合并结果数据] //lead合并结果数据，如失败或者未登录，则不需要响应此数据

}

注：lead合并结果数据：

{

‘电话号码’:{

success_count’:x, //成功记录数，如失败或者未登录，则不需要响应此数据

error_count’:x //失败记录数，如失败或者未登录，则不需要响应此数据

items : [lead数据]

},

…… //其他电话号码的重复数据

}

注：lead数据字段：

前端展示来源时，如果comefrom为1，则展示渠道名称，为2，则展示渠道名称->营销活动关键字，其他情况来源展示comefrom代码对应的名称（3：客户；4：采购；5人工录入；6：其他）。

后台查询数据分页处理时总数据量统计的是符合条件的IP 去重后的数据量，当前页的数据集也是IP去重后的数据量，比如，每页显示10条记录，则当前页要有10组IP分组的数据集（实际数据量可能超过10条，因为每个IP分组下可能有多条记录——IP相同的记录）

此接口分页、查询是针对手机号分组进行分页及条件查询。

Lead分配

接口URL:base_url/lead/distribute

交互方式：POST JSON

交互参数：复杂JSON格式

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘distribute_count’:x //分配记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{lead数据}] //lead数据列表，如失败或者未登录，则不需要响应此数据

}

注：lead数据字段：

前端展示来源时，如果comefrom为1，则展示渠道名称，为2，则展示渠道名称->营销活动关键字，其他情况来源展示comefrom代码对应的名称（3：客户；4：采购；5人工录入；6：其他）。

进行数据分配时，只分配未分配过的，已分配过的不进行重复分配。

Lead分配结果

接口URL:base_url/lead/distributeresult

交互方式：POST JSON

交互参数：复杂JSON格式

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{lead数据}] //lead数据列表，如失败或者未登录，则不需要响应此数据

}

注：lead数据字段：

前端展示来源时，如果comefrom为1，则展示渠道名称，为2，则展示渠道名称->营销活动关键字，其他情况来源展示comefrom代码对应的名称（3：客户；4：采购；5人工录入；6：其他）。

Lead导入批次列表

接口URL:base_url/leadimp/list

交互方式：POST form data

交互参数：

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{lead导入批次数据}] //lead导入批次数据列表，如失败或者未登录，则不需要响应此数据

}

注：lead导入批次数据字段：

Lead导入批次明细记录

接口URL:base_url/leadimp/detail/{id}

交互方式：RESTFul

交互参数：导入批次记录ID，直接包含在URL中,{id}即为导入批次记录ID，以post的方式交互

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘imp_lot’:{lead导入批次记录数据} //lead导入批次记录数据，如失败或者未登录，则不需要响应此数据

‘items’:[{Lead数据}] //Lead数据列表，如失败或者未登录，则不需要响应此数据

}

注：lead导入批次记录数据字段：

lead数据字段：

前端展示来源时，如果comefrom为1，则展示渠道名称，为2，则展示渠道名称->营销活动关键字，其他情况来源展示comefrom代码对应的名称（3：客户；4：采购；5人工录入；6：其他），按照行号升序排序

此接口的分页参数针对的是明细记录，而非批次记录。

Lead导入日志关联记录

接口URL:base_url/leadimp/referral/{id}

交互方式：RESTFul

交互参数：lead记录ID，直接包含在URL中,{id}即为lead记录ID，以get的方式交互

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘total’:x, //总记录数，如失败或者未登录，则不需要响应此数据

‘items’:[{Lead数据}] //Lead数据列表，如失败或者未登录，则不需要响应此数据

}

lead数据字段：

注：返回的lead数据数组是imp_id等于参数上的id的数据数组，此接口主要是查看关联的Lead数据

Lead导入

接口URL:base_url/leadimp/import

交互方式：POST form data

交互参数：

响应数据格式：JSON

{

‘flg’:x, //状态，0：失败；1：成功；2：有异常；-1：未登录

‘msg’:’xxxxxx’, //消息，失败原因，参数错误或者是系统内部错误

‘imp_lot’:{lead导入批次记录数据} //lead导入批次记录数据，如失败或者未登录，则不需要响应此数据

‘total’:x, // lead导入数据总记录数，用于分页，如失败或者未登录，则不需要响应此数据

‘imp_items’:[{lead导入数据}] //lead当前导入批次的数据列表，如失败或者未登录，则不需要响应此数据

}

注：lead导入批次记录数据字段：

lead导入数据字段：