站方旧数据迁移

最后更新:2015-12-10


文档约定及说明

约定:以下文档中称接口开发方为站方,航加房产项目程序称为系统

说明:站方返回参数说明中,必选标记为“是”的,在接口中必须返回该字段内容,否则就不需要开发该接口,因为缺少这些字段数据不会被写入。必选标记为“否”的,能提供该字段内容的可提供,不能提供的则不用返回该字段,如果没有该字段数据却返回了该字段值为null等其他值,将导致数据写入出错。


安全验证(可选)

为了保证站方数据的安全,站方接口对请求方验证身份无误后再输出数据。验证流程与微信开放平台类似。系统请求会携带nonce、timestamp、signature和token四个参数,其中token可在房产项目后台迁移数据接口配置中查看到,站方将nonce、timestamp、token参数进行字典序排序,将三个参数字符串拼成一个字符串进行sha1加密,再将加密后的该字符串与signature参数进行对比是否一致,以确定请求来源是否为本系统。

验证代码示例:

$signature = $_GET["signature"];
$timestamp = $_GET["timestamp"];
$nonce = $_GET["nonce"];
$token =TOKEN;
$tmpArr = array($timestamp, $nonce,$token);
sort($tmpArr, SORT_STRING);
$tmpStr = implode($tmpArr);
if( sha1( $tmpStr ) != $signature ) exit;//验证结果不一致的话则中断数据输出

导入顺序

数据的导入是有一定的顺序的,数据之间的关联需要数据的互相支撑,因此导入数据时的顺序大致如下图,图中文字左侧数字代表导入序号。图中树结构的同一级中,需要先导入序号小的数据再导入序号大的数据,父子级中,先导入父级数据,再导入子级数据(子级中继续按序号先后导入,依此类推)。

若前面的支撑数据无法提供,则不建议继续往后面开发其他数据接口了。举个例子:站方没有集客订单数据,那么看房团活动订单就不需要开发了,因为看房团活动订单是需要与现有的集客订单数据关联。

screen


具体接口开发规则

1. 地区分类

2. 建材商家分类

3. 小区楼盘

4. 小区图库

5. 商家

6. 商家分店

7. 建材商家相册

8. 建材商家案例推荐

9. 建材商家自定义页面

10. 效果图

11. 在建工地

12. 集客订单

13. 订单分配关系

14. 商家回访记录

15. 资讯分类

16. 资讯文章