首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

看接口文档,对产品经理有用吗?

停更一年多了,编辑个图文都吃力

一年发生了什么呢?怎么都没人说话了呢?没错一年,元宝和yaojif都来到了互联网金融领域,继续在产品坑中折腾~

17这一年,很忙,没人管;多忙呢,忙到三位同学同在广州深圳,却一年聚不到3次那种;

信息过载和冗余,几次想写东西,想了下又放弃了,所以说没时间其实都是懒的托词(打脸打脸)~

今天在星爸爸码了这篇文章,没有草稿,一杯咖啡的时间,写了些和职业有关的东西,当然还有很多想法,或许有机会以后会接着更呢~

正文分割线

模拟个日常的场景

A同学是一个互金产品经理,在优化用户充值功能时候需要和一个第三方支付公司对接。A同学需要新设计一套产品前端交互逻辑,但此时是一脸懵逼状态。

于是A同学采用了一个很常规的方式来做研究并设计--竞品体验;通过找到相应用此第三方的竞品,体验几遍产品流程来从而来设计自己产品的前端逻辑。于是在产品设计阶段参照着竞品,加以创新后把PRD提交给了技术,开发评审中,被技术小伙伴一顿狂飙“你这个不能用短信验证码来验证”、“充值必须为整数”、“二类银行卡是不能充值的”......“X经理,你先看看接口文档再做设计吧~”。

于是A同学赶忙找到支付公司对接人,把开发的问题都问了一遍,对接人扔了一份文件回来,“你的问题都可以在我们的接口和PRD文档中找到相应的解决方案噢......”

接口文档从哪儿来

产品同学们可能或多或少会碰到接口文档东西,特别是在做第三方系统功能对接时候,对方对接人一般会给我们这边的技术对接人发一份接口文档,而不一定会给对接的产品经理发。

什么是接口和接口文档

接口是啥,接口又叫API,用我自己的话来讲,其实就是研发的小伙伴使用的一个包装好的对接工具(说得很土也很不专业哈),研发同学使用这些接口来完成功能开发,或者通过修改接口来更改具体的业务功能和适配性等等。

接口文档是啥,就是定义和说明整个相关项目需要用到的API文档。

一般的接口文档中一般包括

接口说明:接口名称、接口描述、业务规则、接口模式、同步异步等

接口参数:接口中参数的定义和说明、请求参数、返回参数等

接口说明

接口参数

以上是为某银行存管系统接口文档

那么,产品同学为什么要阅读接口文档呢?

最直接的好处,在你了解了具体的技术实现逻辑后,你所设计的产品才有很高的可执行性,说白点就是可以理直气壮地和研发同学愉快的互怼!

其实对于很多技术转产品的同学,他们都会有设计前阅读接口文档的习惯,毕竟是老本行的工作惯性在那儿。所以其实强调阅读文档更多是针对没有技术背景的产品同学们

好处好处好处在哪儿,需求在哪儿呢!!

一、浅层好处(出活、做事)

a.可以极大提高设计效率

b.增强产品设计产出方案的可执行性

c.把握接口变化规则,及时响应变化(这一点尤其是金融第三方的接口,受政策影响极大,更需要密切关注接口的更新迭代)

二、深层好处(为人、内心需求)

a.愉快地和开发配合

b.理直气壮地和开发互怼

c.对内对外更能呈现你的专业性和严谨性

三、终极好处

a.能拓展自己的产品思维,对于偏技术的api文档来说,很多设计也是非常巧妙的,特别是在兼容性方面

b.给自己注入一点开发者思维,对把控整一个产品有极大的帮助,其实技术同学的迭代思维明显比产品同学高点

c.通过文档深层了解设计者的意图,设计者为什么要设计出这种功能和结构的接口呢?是行业政策,还是外界发展,亦或是用户导向,了解事物的本质,其实更有助于让我们带着同理心了解一些外部内容

产品的本质就是人性把控,只有更广泛地接受更多的东西,才能让我们的产品更有灵魂;所以周围的事情、资源,也许都是我们的金矿

  • 发表于:
  • 原文链接http://kuaibao.qq.com/s/20180326G11NSL00?refer=cp_1026
  • 腾讯「腾讯云开发者社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。
  • 如有侵权,请联系 cloudcommunity@tencent.com 删除。

扫码

添加站长 进交流群

领取专属 10元无门槛券

私享最新 技术干货

扫码加入开发者社群
领券