站方旧数据迁移
最后更新:2015-10-08
文档约定及说明
约定:以下文档中称接口开发方为站方,航加房产项目程序称为系统。
说明:站方返回参数说明中,必选标记为“是”的,在接口中必须返回该字段内容,否则就不需要开发该接口,因为缺少这些字段数据不会被写入。必选标记为“否”的,能提供该字段内容的可提供,不能提供的则不用返回该字段,如果没有该字段数据却返回了该字段值为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;//验证结果不一致的话则中断数据输出
导入顺序
数据的导入是有一定的顺序的,数据之间的关联需要数据的互相支撑,因此导入数据时的顺序大致如下图,图中文字左侧数字代表导入序号。图中树结构的同一级中,需要先导入序号小的数据再导入序号大的数据,父子级中,先导入父级数据,再导入子级数据(子级中继续按序号先后导入,依此类推)。
若前面的支撑数据无法提供,则不建议继续往后面开发其他数据接口了。举个例子:站方没有集客订单数据,那么看房团活动订单就不需要开发了,因为看房团活动订单是需要与现有的集客订单数据关联。