你们公司是由谁定义接口,写接口文档的?app端还是后端?

[复制链接]
382 19
如题,公司领导要求写接口文档。之前没写过,该怎么写呢?
另外你们公司是由谁定义接口,写接口文档的?app端还是后端?

举报 使用道具

回复

19 个评论

beast  新手上路  发表于 2018-9-11 14:53:40  | 显示全部楼层
如题,公司领导要求写接口文档。之前没写过,该怎么写呢?
另外你们公司是由谁定义接口,写接口文档的?app端还是后端?

举报 使用道具

回复
beautiful_night  新手上路  发表于 2018-9-11 15:05:57  | 显示全部楼层
肯定是后端啊,谁写接口谁做文档么。

举报 使用道具

回复
issac-lam  新手上路  发表于 2018-9-11 15:10:02  | 显示全部楼层
对的,一般应该都是后台做接口写文档。现在领导要求和后台一起弄文档,这个怎么整呀。。。 之前都是拿着后台给的现成文档写页面的。。。

举报 使用道具

回复
yyuan  新手上路  发表于 2018-9-11 15:28:45  | 显示全部楼层
emmm。。我曾经负责写接口文档。

就是说我根据页面来决定如何获取数据,获取数据的格式等等。

接口路径、请求参数、请求方式、请求格式、返回的数据内容和格式都是我来定。

后台只负责按我写的文档进行实现就行。


补充点我的理解吧。


首先要对你自己的app所有界面有一定了解。这样才能设计出合理的接口。


根据实际需求考虑接口的聚合或拆分。比如:搜索功能。如果有多个地方用到不同种类的搜索。那么做成一个个搜索接口比较合理;反之如果只有一个页面有搜索,不同的搜索选项比较集中。那么可以做成一个搜索接口,根据不同选项传不同的参数即可。


根据返回内容消耗的时间或性能考虑。如果接口返回时间过长且无法优化的话,就要考虑进行拆分或者精简返回。


最重要的一点,一定要为以后迭代埋下伏笔。需求总是会变的。。。
[ 此帖被ad0ma在2018-04-26 16:37重新编辑 ]

举报 使用道具

回复
乱来  新手上路  发表于 2018-9-11 17:09:23  | 显示全部楼层
谁闲谁写

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有帐号?立即注册

x

举报 使用道具

回复
kingsley  新手上路  发表于 2018-9-11 17:18:28  | 显示全部楼层
谢谢

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有帐号?立即注册

x

举报 使用道具

回复
12345mylove  新手上路  发表于 2018-9-11 17:20:21  | 显示全部楼层
的确..经常被抓取写

举报 使用道具

回复
343705365  新手上路  发表于 2018-9-11 17:52:12  | 显示全部楼层
一起弄就行啊,你要什么数据,要怎么样格式的数据,自己定义好了,到时候开发也方便,不然后台如果写的不好,用起来都不好用。

举报 使用道具

回复
tiankongphil  新手上路  发表于 2018-9-11 18:01:49  | 显示全部楼层
虽然说前端后端都需要考量。但是主要还是后端吧,毕竟数据都在他们那,我们需要的是要什么格式的。什么字段的内容。剩下的怎么处理是后端来的吧。

举报 使用道具

回复
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

ios.irunthink.com
搜索
热搜: iOS swift 下拉刷新

图文热点

更多

开发教程

更多

客服中心

400-800 周一至周日 9:30-17:30 仅收市话费

关注我们

  • 微信扫描
  • 关注微信
关于我们
关于我们
友情链接
联系我们
帮助中心
精贴推荐
源码上传
注册登录
服务支持
资源下载
关注我们
官方微博
官方空间
快速回复 返回顶部 返回列表