构建开发人员喜欢的API “产品人员-产品经理,产品设计师,UX设计人员,UX研究人员,业务分析师,开发人员,制造商和企业家 June 06 2017 真正 阿皮 ,业务模型,文档,SDK, 注意产品 介意产品有限公司 689 马克西姆·普拉德(Maxime Prades)解释了如何构建开发人员在ProductTank SF上喜欢的API 产品管理 2.756

构建开发人员喜欢的API

通过 ON

马克西姆·普拉德(Maxime Prades) (Zendesk产品总监) 带您体验在Zendesk建立平台并成为API-first公司的一部分的经验。他通过描述Zendesk的明确价值开始演讲。’的API正在为其客户帐户和业务提供服务。例如,在30天的试用期内使用rest API的客户帐户的转化次数是原来的两倍。同样,平均数“seats”由不持有的帐户持有’t use APIs is 6. If accounts are using the rest API this increases to 32 average 座位. Maxime describes the basics of what an API is, why it is so powerful and what he learnt along the way.

您如何向孩子描述API?

Maxime说,他向从业务开发到API专家的每个人问这个问题!他最喜欢的描述是API本质上是每个人都能理解的语言。我说法语,其他人可能说德语。 API建立了参考框架,让我们彼此了解。这是您做出的每个产品决定的核心。同样,您也可以将其描述为连接两个不同岛屿的桥梁。

为什么要有API?

桥梁和翻译使事情变得更快。在Zendesk,第一个API由Ruby on Rails免费提供,开发人员在不加思索的情况下将其作为一个小奖励。它被放置在公共网站上,这是6年的API。然后他们达到了它做不到的地步’t scale and wasn’t working.

他们没有按原样废弃或维护它,而是将所有结构重新构建到restAPI上,从而成为API优先的公司。他们使用与客户完全相同的API,它已成为他们的主要产品之一。作为API领先的公司,Zendesk通过多种方式提高了速度:

  • 具有缓存网页之类的微服务,彼此之间的响应速度更快
  • Zendesk可以在任何地方的客户中,动态地响应未来的需求,或者客户可以通过API自助服务自己的需求
  • 通过内部使用自己的API,Zendesk可以在客户发现之前发现并修复错误。
  • 首先为任何功能开发API都可以让他们配置和管理复杂性,从而避免混乱

Maxime为构建API的产品经理提供了大量有价值的建议,例如:

  • 有一个业务目标。 Maxime描述了他们如何知道Zendesk API对业务有用,但是他们直到了解统计信息才知道。一旦他们做到了,他们就可以确定它所提供的确切收益,并据此创建业务模型。
  • 请记住,API将被嗅探。即使您尝试隐藏它,人们也可以找到它。 Maxime警告您不要理会您所有的事情’我已经阅读了有关保护API的信息。大型公司发生的所有黑客攻击都使用私有API。因此,即使您决定将API设为私有,也要确保您的业务像公开业务一样安全。
  • 使其可用。没有标准,API的使用和集成将变得非常痛苦。没有文档,开发人员将无从下手。为此,他们开发了Double Doc-库,该库允许用户用代码编写文档。这意味着开发人员每次更新代码时,他们都会’提示您立即进行记录。
  • 尽量不要破坏它。 Maxime将公共API描述为与客户的隐性合同,如果在不告知客户的情况下进行更改,则会损害业务关系。他建议使用开发人员新闻通讯,并要记住,沟通过度比愤怒的电子邮件或帐户取消更好。’如果他们只有在发生问题时才发现问题,我才会收到。
  • 多走一英里:构建SDK,包装程序,开发人员工具,控制台,以便他们可以测试API调用等。’产品经理负责思考最终用户以及如何满足他们的迫切需求的角色。不要建立API,然后忘记让开发人员 ’s life easier.