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

网络引流系统前后端数据交互接口设计
网络引流系统采用前后端完全解耦的方式进行写作开发，前端主要责任是实现跟用户之间的界面交
互，后台的主要责任是进行业务逻辑的处理及业务数据的持久化，前后端通过http协议进行性代不可，如果没有模板id，属性代可，没有模板id的明是用手工添加的属性。另外，有模板id的，如果模板上定的属性是不
可除的，条属性是不能除的，界面上的属性不需要除按及操作，后台也不能除此属性，如果模板定的属性是必填的，条属性的不能空，前端后端就要行。
加渠道属性
接口URL:base_url/channel/props/{id}
交互方式：RESTFul
交互参数：渠道记录ID，直接包含在
响应数据格式：JSON

URL中,{id}

即为渠道记录

ID，以

get

的方式交互
{
‘flg’:x,
‘msg’:’xxxxxx’,
‘total’:x,
‘items’:[{渠道属性数据

}]

//状态，0：失败；1：成功；-1：未登录
//消息，失败原因，参数错误或者是系统内部错误
//总记录数，如失败或者未登录，则不需要响应此数据
//渠道属性数据列表，如失败或者未登录，则不需要响应此数据
}
注：渠道属性数据中，需要额外的字段，可删除、必填，字段数据来源于属性模板表。
属性那里，如果有模板id的，属性代码不可编辑，如果没有模板id，属性代码可编辑，没有模板
说明是用户手工添加的属性。另外，有模板id的，如果是不可删除的，则这条属性是不能删除的，界面
上对应的属性不需要删除按钮及操作，后台也不能删除此属性，如果是必填的，则这条属性的值不能为
空，前端后端就要进行验证。渠道属性模板的类别为channel_props_tmpl。

id

的
加载渠道营销活动
接口URL:base_url/campaign/list/{id}
交互方式：RESTFulPOSTJSON
交互参数：渠道记录
ID包含在URL中,{id}
即为渠道记录ID，单层JSON格式
参数名称
参数说明
备注
page
当前页
如未提供此参数，默认为0
pagesize
每页记录数
如未提供此参数，默认全部
name
名称或关
键字模糊
如未提供此参数，则查询所有的数据，否则模糊匹配符合
查询条件
条件的记录
sortcol
排序字段
如未提供此参数，默认用创建时间降序排序
descsort
降序排序
此参数结合sortcol参数使用，如未提供此参数，默认升
序排序，否则降序排序，此参数值为true
或者false
响应数据格式：JSON
{
‘flg’:x,
//状态，0：失败；1：成功；-1：未登录
‘msg’:’xxxxxx’,
//消息，失败原因，参数错误或者是系统内部错误
‘total’:x,
//总记录数，如失败或者未登录，则不需要响应此数据
‘items’:[{营销活动数据}]
//营销活动数据列表，如失败或者未登录，则不需要响应此数据
}
注：营销活动数据字段
字段
说明
来源
id
ID
营销活动表
channel_id
渠道ID
营销活动表
name
营销活动名称
营销活动表
keyword
营销活动关键字
营销活动表
price
营销活动价格
营销活动表
remark
营销活动说明
营销活动表
link_code
引流标识码
营销活动引流点对应表
cplink_state
状态，营销活动引流点对应关系状态
营销活动引流点对应表
customer_id
客户ID
客户信息表
customer_name
客户名称
客户信息表
linkpoint_id
引流点ID
引流点信息表
linkpoint_url
引流点URL，即客户入口URL
引流点信息表
created_date
创建时间
营销活动引流点对应表
creator_id
创建人ID
营销活动引流点对应表
creator_name
创建人姓名
用户表
link_url
引流系统入