App开发注意事项

来自技术开发小组内部wiki
跳转至: 导航搜索

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进行查看。