App开发注意事项
APP接口开发注意事项
1.新功能开发是,如果跟之前代码差别不大,就不用再在代码库开新版本。
2.api/v2_0下的文件目前包含app版本从V2.0到V3.10的全部代码。在编写新功能是,如果需要修改原来接口,需要考虑是否加版本限制。H5或pc上新功能时,需要考虑app端是否支持,不支持需要跟产品考虑,是否进行新功能产品的屏蔽。
3.app新版本需要生成新的加密串。方法是controller目录下的test.php的random_string。生成的新串需要放到api.config对应的版本选项下,不可外传。
4.app端下单支付功能是由服务器端来控制的,目前在V2_0/other/index_special_recommend下。
5.ios的第三方qq登陆也是在服务器端控制,ios审核时由于地域原因qq无法进行登陆,需要隐藏qq登陆选项。
6.app上线新版本时需要在后台客户端设置模块,增加相应的客户端版本。
7.长线游产品的接口是单独出来的,没有掺杂在普通活动里。
8.注意事项:
<1>订单模块:a.酒店订单详情和普通订单详情接口是区分开的,修改时需要注意。b.购物车下单和单个下单接口是分开的。
<2>首页推荐栏:支持自定义列表,需要在后台管理客户端首页推荐栏模块增加对应的方法名设置。
9.目前服务器端记录了客户端用户设备信息,客户端版本信息,用户设备硬件信息等,需要待开发。
10.接口输出格式为json。
wiki编写规范
1.新功能需要在api文档说明对应模块进行功能及接口说明。
2.在原来接口上修改的功能,如果返回参数改变,需要在wiki上及时补充。
3.wiki编写完,需要告知客户端开发人员,并进行必要的功能说明和规则说明。
4.编写规范参照之前的就可以。
本地调试
1.本地调试可使用:[1],根据版本号进行接口参数传入,然后看返回接口。新功能调试,需要将新功能地址加入到fmb.dianping\application\controllers\api\apitools\apitools.php文件中。 [1],根据版本号进行接口参数传入,然后看返回接口。新功能调试,需要将新功能地址加入到fmb.dianping\application\controllers\api\apitools\apitools.php文件中。 http://api.fumubang.net/apitools/apiTools,根据版本号进行接口参数传入,然后看返回接口。新功能调试,需要将新功能地址加入到fmb.dianping\application\controllers\api\apitools\apitools.php文件中。
2.还可以使用监测系统http://192.168.28.204/login.php?table=logs&excludeHost=0&host2=&host%5B%5D=fumubang&excludeProgram=1&program2=&excludeFacility=1&excludePriority=1&date=&time=&date2=&time2=&limit=50&topx=10&orderby=fo&order=DESC&graphtype=tophosts&msg1=&msg2=&msg3=&pageId=Search进行查看。
3.dev环境下也可进行本地调试,需要将本机ip加入到api.config文件的api_debug_ip选项。默认返回xml格式文件。
线上接口测试
1.线上接口调试可使用:[1],根据版本号进行接口参数传入,然后看返回接口。新功能调试,需要将新功能地址加入到fmb.dianping\application\controllers\api\apitools\apitools.php文件中。 http://api.fumubang.net/apitools/apiTools,根据版本号进行接口参数传入,然后看返回接口。新功能调试,需要将新功能地址加入到fmb.dianping\application\controllers\api\apitools\apitools.php文件中。
2.还可以使用监测系统http://192.168.28.204/login.php?table=logs&excludeHost=0&host2=&host%5B%5D=fumubang&excludeProgram=1&program2=&excludeFacility=1&excludePriority=1&date=&time=&date2=&time2=&limit=50&topx=10&orderby=fo&order=DESC&graphtype=tophosts&msg1=&msg2=&msg3=&pageId=Search进行查看。