API 产品管理:最佳实践

22-09-11 banq

API是代表应用编程接口的首字母缩写,它是计算机服务之间的安全通信合同。用更简单的话说,它是一个允许计算机相互对话的结构。它就像一个连接两端的胶带,只是这次的两端是接口和数据库。但是,API究竟是如何让两台计算机之间进行通信的呢?一旦API被激活,它就向代码库请求数据并返回答案。

API产品的组成部分是界面、参与、学习和可用性辅助工具,以及可见性和分析。

API可以是:
  • - 作为一种服务。
  • - 作为跨平台的互动/体验。
  • - 作为一个产品。


在这篇文章中,我们将重点讨论作为产品的API。作为产品的API具有独特的价值主张;需要不断地学习和改进API,并涉及影响的衡量,这可能是收入。将API视为产品,有助于企业认识并向消费者提供一致的价值。

API产品管理与前端产品管理有类似的愿景和背景:
有一点不同的是,API为应用程序增加了独特的价值。例如,Bolt应用程序依赖于谷歌地图API来寻找坐标,追踪准确的点,寻找路线并确定Bolt骑行的到达时间。这些价值是使博尔特应用程序成为博尔特应用程序的原因。

API产品管理是负责组织的API战略的规划、实施和整体成功的组织职能。
API产品经理在开发任何设计良好的最终用户应用程序时应遵循类似的思维过程,与组织的目标和收入目标保持一致。

API产品经理的最佳实践
优秀的API产品经理将API视为扩大业务规模和建立受人尊敬的伙伴关系的工具。这就是为什么产品经理必须采取措施,确保API提供价值并解决具体问题。

在这篇文章中,API产品管理。在这篇文章中,你将了解到在某些方面打钩以提高API采用率的重要性--安全性、一致性、简单性、变更管理、开发者体验和分析是导致API成功的基本考虑因素。

安全性
保密性是所有API的关键,消费者必须知道他们的数据是安全和加密的。OAuth和HTTPS是保持安全的机制。它们的作用是什么?OAuth让开发者安全地访问你的用户数据,而不需要分享他们的密码,这些数据通过一个叫做HTTPS的安全通道。HTTPS(安全超文本传输协议)是用户的计算机和网站之间的一种安全通信形式,HTTPS确保端到端的数据加密。

单个客户必须只访问他的数据,渗透到数据库的可能性应该是几乎不可能的。内部API可能必须保密,以避免可能危及组织的漏洞。团队中最好有一个网络安全专家来指导API的安全事宜。

简单性
"你的产品很好,但很难用"。
API文档应该简单明了,让开发者、产品经理和合作伙伴能够理解和使用。

应检查和修改可能影响API集成的法律限制,以改善API的访问和采用。简化的API整合过程借助于阐述清楚的文档将推高API的采用。

变更管理
API中的一个小的更新可能会干扰你的集成中的一些重要的东西,导致API中的巨大损失。有必要对文档和沟通进行重点关注,以使开发人员和合作伙伴及时了解新的更新。

更新=问题
沟通变化,为API添加新的版本号,并对API进行折旧以允许现有用户有一个宽限期,这对于管理API中可能出现的变化至关重要。对于开放的API,这可以通过发送推送通知、电子邮件和在API文档中包括新的更新来完成。

获得反馈的最佳方式之一是通过开发者社区。就我个人而言,我熟悉Interswitch和Paystack的开发者Slack社区--开发者可以在那里发出询问和投诉。新的公告会在频道上发布,并作为向其他开发者学习的途径。

衡量成功(分析)
分析学的本质是为你提供信息以做出更好的决定。这些信息可能意味着许多事情。它可能表明,流量上升是因为API做得很好,但流量下降可能意味着API被不适当地使用,导致流量放空。使用API度量、Visual Studio Application Insights和API science等工具来监控API。

跟踪API调用,使用它的开发者和应用程序,提供的服务质量,以及第三方使用它所提供的收入。

你将需要指标来帮助你决定增加或删除哪些功能。

最后的思考
如果你想成为一个没有技术背景的API产品经理,我建议你熟悉API的术语--谈论API。你不希望开发人员把你搞糊涂了!!。

评估一些你熟悉的技术的API文档;例如 - Interswitch API doc, Paystack API doc, Paypal API doc 或者简单地访问API explorer来检查不同的API。


一致的体验

API的体验应该在不同的平台上保持一致--Android、iOS、Windows和,Linux,以获得良好的用户体验。因此,API产品经理应该了解如何在各种平台上进行合理化和横向工作。为了获得积极的开发者体验,API的端点命名也需要一致性。你可以在这里查看一些端点命名规则。

关注开发者体验(DX)
就像应用程序的终端用户体验一样,开发者体验也是至关重要的。优先考虑消费开发者,并根据开发者的反馈进行设计。与终端用户不同,开发者的反馈更直接。尽管你的角色看起来很技术化,但别忘了满足用户的需求和优先考虑组织目标是你的关键职责。