旧数据迁移/集客订单
最后更新:2015-12-14
接口说明
导该数据可能需要使用接口/api/info/getorderstatus(点击查看接口说明)转换订单相关数据
导该数据可能需要使用接口/api/info/getordercontent(点击查看接口说明)转换订单内容相关数据
系统请求方式
GET
系统请求参数说明
参数 | 说明 |
---|---|
page | 页码,初始从1开始表示第一页 |
站方返回参数
为保证性能,站方每次列出最多100条数据,以数据id正序排序,系统会以分页的形式携带参数page分批次请求,直到无数据返回会停止请求,站方返回每一页数据即可。 站方返回数据格式须为json,格式如下:
[
{
"name": "汪大旗",
"phone ": "18935221415",
"aid": "12545",
"account": "糜糜的名字太短",
"address": "常州市新北区太湖东路",
"sid ": "123",
"size": "123",
"budget": "12-13万",
"visit_time": 1432545451,
"bedroom": 2,
"livingroom": 1,
"source": "首页",
"bathroom": 1,
"plot_name": "金色新城",
"start_time": 1435545474,
"shop_id": 313,
"shop_name": "一米家居",
"status": 2,
"visited": 4,
"stage": 2,
"style": 3,
"bao": 3,
"is_key": 1,
"is_marry": 0,
"note": "二次回访备注",
"request": "希望风格是简欧,由于房子不大,实得面积是90,保持两居室+1书房,书房不一定要中规中矩,想要一个小的衣帽间,8月交付",
"start_time": 1423654569,
"delivery_time": 1465242120,
"created": 1423521410,
"ip": 127.0.0.1,
},
{
...
}
]
站方返回参数说明
参数名 | 必选 | 说明 |
---|---|---|
id | 是 | 主键id |
name | 否 | 提交订单的用户名 |
phone | 是 | 提交订单用户的手机号 |
address | 否 | 订单用户住址 |
aid | 否 | 提交订单用户的论坛id |
account | 否 | 提交订单用户的论坛用户名 |
sid | 否 | 提交用户的意向商家id |
size | 否 | 用户的新房面积 |
budget | 否 | 用户的装修预算 |
visit_time | 是 | 工作人员回访的时间,UNIX时间戳 |
bedroom | 否 | 用户新房有几室 |
livingroom | 否 | 用户新房有几厅 |
bathroom | 否 | 用户新房有几卫 |
source | 否 | 订单提交的来源(文字类型,如“首页”、“商家店铺详细页”等) |
plot_name | 否 | 用户新房的小区名称 |
start_time | 否 | 用户装修开工时间,UNIX时间戳 |
shop_id | 否 | 最终选定的装修商家id |
shop_name | 否 | 最终选定的商家名称 |
status | 否 | 订单状态,需要使用接口转换数据,点此 |
visited | 否 | 回访状态,需要使用接口转换数据,点此 |
stage | 否 | 装修进度,该字段为枚举值,0 表示未开工,1 表示装修中,2 表示已装修,3 已入住,请按对应的四种状态返回相应的值 |
style | 否 | 用户期望的装修风格,需要使用接口转换数据,点此 |
bao | 否 | 装修方式,需要使用接口转换数据,点此 |
is_marry | 否 | 是否婚房,该字段为枚举值,0 表示不是,1 表示是 |
is_key | 否 | 是否有钥匙,该字段为枚举值,0 表示没有,1 表示有 |
note | 否 | 二次回访的备注 |
request | 否 | 装修要求,这是客户提交表单时填写的 |
start_time | 否 | 装修开工时间,UNIX时间戳 |
delivert_time | 否 | 装修的交付时间,UNIX时间戳 |
created | 否 | 用户订单提交时间,UNIX时间戳 |
ip | 否 | 用户订单提交来源id |
迁移完成后续操作
无
/api/info/getorderstatus
【返回接说明】
该接口返回与订单相关的一些状态标识,以json格式输出。请根据上文要求适当选择接口返回的标识数据。
【返回内容】
{
"visit": {
"0": "未回访",
"1": "已回访",
"3": "未接通",
"4": "稍后联系",
"5": "以后沟通"
},
"status": [
"新需求",
"跟进中",
"已分配",
"已结束",
"未计划",
"已删除"
]
}
【返回参数说明】
参数名 | 说明 |
---|---|
visit | 订单的回访状态标识,该参数返回的是键值对形式的json对象,数据转化时只需使用数据中的数字键名即可 |
status | 订单状态标识,该参数返回的是键值对形式的json对象,数据转化时只需使用数据中的数字键名即可 |
数据接口返回的json数据中可能没有数字键名(如上面示例中的status数据),则直接使用json_decode后得到的键名即可(如array(0=>'新需求',1=>'跟进中'))。
/api/info/getordercontent
【返回接说明】
该接口返回订单内容的选择项,若旧数据中有这些选项,请将选项的旧数据转换为新数据
【返回内容】
{
"bao": {
"1": "半包",
"2": "全包",
...
},
"style": {
"11": "地中海",
"12": "中式",
...
}
}
【返回参数说明】
参数名 | 说明 |
---|---|
bao | 用户装修方式 |
style | 用户希望的装修风格 |
每个参数的值是一个json对象,对象中是键值对。
举例:
站方用户订单旧数据中有个选择项是记录用户的建材需求的,并且值为6,表示需要沙发,而系统接口返回的建材需求参数中,对应的沙发需求是2,那么站方给出数据时,就要将这个6改为2给出来。