# API文档
## 获取任务名称和配置接口
* 接口地址：http://域名/index/api/tasktype
* 请求方式：post
* 请求参数：json格式
aipkey：登录会员中心获得
* 请求示例
~~~
{
"apikey": "CO8syB7pgK3kD99U"
}
~~~
* 返回数据
code 状态码 200-正常； 101- 报错
msg 提示信息
data 任务信息数组
* 返回示例
~~~
{
"code": "200",
"msg": "success",
"data": [
{
"id": "190",//任务ID
"task_name": "APP搜索流量",//任务名称
"ptid": "1",//平台ID
"pt_name": "淘宝天猫",//平台名称
"fid": "5",//项目ID
"ft_name": "流量/加购",//项目名称
"client": "APP",//终端
"config": {//任务配置规则，下单时会校验对应的任务规则参数
"lianjie": {
"name": "商品链接",
"tishi": "请输入宝贝链接",
"ltype": "",//链接类型:taobao,ali,jingdong,weixin,pinduoduo,zbkl:直播口令,daren:达人任务,zhibo:聚划算
"xuanshi": 1,//选择任务启动时间，1必填，0非必填
"wang": 0,//填写旺旺号，1必填，0非必填
"drly": 0,//选择达人来源，1必填，0非必填
"okt": 0//完成时间选择 ，1必填，0非必填
},
"biaoti": {//任务标题提示文案
"name": "商品标题",
"tishi": "请输入商品标题"
},
"guanjianci": {
"name": "关键词",//关键词提示文案
"beishu": "1",//任务倍数，例如：100时，下单时只能按100的倍数下单
"fenpei": "1",//默认分配规则，0：手动分配 1：自动分配 2：按计划分配
"duoge": 1,//是否允许多个关键词，1允许，0不允许
"ci": 1//是否允许添加关键词，1允许，0不允许
},
"tingliu": "",//暂未实现功能，备用字段，用于停留时间
"fubao": "",//暂未实现功能，备用字段，用于浏览宝贝深度
"pingjia": ""//暂未实现功能，备用字段，用于查看评价
},
"tishi": "",//任务提示文案
"status": "1",//任务状态
"price": "0.12"//任务价格
}
]
}
~~~
## 任务下单接口
* 接口地址：http://域名/index/api/tasksave
* 请求方式：post
* 请求参数：json格式
aipkey：登录会员中心获得
xiangmu：下单任务信息
* 请求示例
**改造注意：每次提交guanjianci字段，请只提交一个关键词，多个请求分别提交，目的在于实现全自动状态的扭转，查询状态会实时返回目标值，已完成值，状态值等信息，任务扭转将更完善！，查询时间间隔请10-20分钟查一次。**
提交的mlink任务链接，请自行校正对应的链接地址：
比如淘宝平台：
商品链接：
https://item.taobao.com/item.htm?id=商品ID
https://detail.tmall.com/item.htm?id=商品ID
店铺链接：
https://xxx.taobao.com
https://xxx.tmall.com
京东：
商品链接：
https://item.jd.com/商品ID.html
店铺链接：
https://item.jd.com/index-商品ID.html
拼多多：
商品链接：
https://mobile.yangkeduo.com/goods.html?goods_id=商品ID
https://mobile.yangkeduo.com/goods2.html?goods_id=商品ID
店铺链接：
https://mobile.yangkeduo.com/mall_page.html?mall_id=店铺ID
~~~
{
"apikey":"WO8uzEG03fjkD99S",
"xiangmu":{
"kaishi":"2020-05-06",//开始时间
"tianshu": 2,//任务天数
"mlink":"32w2",//任务链接
"biaoti":"1321321",//任务标题
"leixing":"191",//任务类型ID，第一个接口获取的id
"wangwang":"",//根据任务规则决定是否填写，旺旺号
"tingliu":"",//根据任务规则决定是否填写，停留
"futingliu":"",//根据任务规则决定是否填写，深度浏览宝贝停留
"fubao":"",//根据任务规则决定是否填写，深度浏览宝贝个数
"pingjia":"",//根据任务规则决定是否填写，评价选择
"beizhu":"",//备注
"qidong":"2020-05-06 00:00:00",//根据任务规则决定是否填写，任务启动的具体时间
"drly":"",//根据任务规则决定是否填写，达人来源 0 微淘内容 1有好货 2 淘宝头条 3全球时尚 4必买清单 5手淘消息中心 6极有家 7哇哦视频
"oktime":"",//根据任务规则决定是否填写， 完成时间
"guanjianci":[//每个关键词的具体分配信息
{
"fenpei":"2",//分配模式 0：手动分配 1：自动分配 2：按计划分配
"hour":"6,3,3,4,3,3,3,4,6,6,10,8,9,13,16,13,16,15,17,15,15,13,13,8",//当分配模式为0 ，1时填写该时间分配刻度，当分配模式为2时，应填写fangan_str字段。
"cname":"12222",//关键词
"renwushu":"12",//平均每天的任务数
"fangan_str":[//计划分配数组，2天起步
{
"number":1,//任务数
"mhour":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0]//分配刻度
},
{
"number":22,
"mhour":[0,0,0,0,0,0,0,0,0,0,0,1,0,3,3,2,2,2,2,2,4,1,0,0]
}
]
}
]
}
}
~~~
* 返回数据
code 状态码 200-正常； 101- 报错
msg 提示信息
* 返回示例
~~~
{
"code": "200",
"msg": "success"
"data": {
"order_no": "5707558778"
}
}
~~~
## 任务状态查询接口
* 接口地址：http://域名/index/api/taskstatus
* 请求方式：post
* 请求参数：json格式
aipkey：登录会员中心获得
order_no：快递下单接口返回的物流单号 支持数组批量查询
* 请求示例
~~~
{
"apikey": "CO8syB7pgK3kD99U",
"order_no": ["5707558778","5707558777"]
}
~~~
* 返回数据
code 状态码 200-正常； 101- 报错
msg 提示信息
* 返回示例
~~~
{
"code": "200",
"msg": "查询成功"
"data":{
"order_no": "YT2880521349369",
"exp_status": "0",// 0待处理，1执行中，2已完成，3已取消，4已退
"renwushu_all": "50",
"renwushu_finish": "4"
}
}
~~~
# 1.4任务取消接口
* 接口地址：http://域名/index/api/taskordercancel
* 请求方式：post
* 请求参数：json格式
aipkey：登录会员中心获得
order_no:订单编号
* 请求示例
**注意** 只有执行状态的订单才允许被取消。其他状态则都会返回失败。取消成功后请继续用查询接口，查询最新状态，查询到exp_status为4时即是订单已退款，闭环结束。
~~~
{
"apikey": "Cr17zBe0gvrkDttS",
"order_no":"EFS000007641096"
}
~~~
* 返回数据
code 状态码 200-正常； 101- 报错
msg 提示信息
* 返回示例
~~~
{
"code": "200",
"msg": "订单取消成功，请等待15-20分钟自动退款到帐号"
"data":""
}
~~~
