如何向非技术受众解释API？

Question

一点背景:我有机会向我国的一家大型汽车共享公司的管理层提出公共API的想法.目前,预订汽车的唯一选择是非常慢的网络界面和难以到达的呼叫中心.因此,我对编写自己的搜索界面,将此功能集成到其他产品和应用程序等中的可能性感到兴奋.

问题是:由于这家公司的特殊性,我首先必须通过一个委托来获得我的建议,这完全由非技术性和相当保守的人组成.如何向这样的受众解释API的概念？

Answer 1

不要像API那样解释技术细节.说明业务问题和业务问题的解决方案 - 以及它将如何影响他们的底线.

Answer 2

HardCode 的答案是正确的，因为您确实应该专注于业务问题和收益。

然而，如果您确实觉得需要解释一些事情，您可以使用医疗接待员的类比。

医疗机构拥有自己的患者数据库和预约安排系统，供其管理人员和医务人员使用。这在内部可能相当复杂。

然而，当您想以患者身份预约时，您可以通过一组简单的命令与接待员交谈 - “我想要预约”、“我想看 X 医生”、“我感觉不舒服”，然后他们就会连接到他们的系统根据您的病史、出现的症状和可用资源，以简单的语言为您预约“明天下午 4:30”。

因此，粗略地说，使用接待员类似于使用 API 的外部程序。它允许您与复杂的系统交互以获得所需的信息，而无需处理内部复杂性。

Answer 3

多年来，销售人员的推销基于两件事：特点和优势。每个功能都应该有相关的好处（对某人，最好是每个人）。在这种情况下，您显然打算将基本上是单体的应用程序分解为（至少）两部分：前端和后端。明显的好处是 1) 每个都独立工作，因此每个开发都更容易。2）不同的人可以开发不同的部分，3）通过简单地购买更多硬件来增加容量更容易。

尽管您没有明确表示，但我猜想其中一个目的是公开记录 API。这允许外部开发人员接管（至少部分）前端代码的开发（通常是免费的，不少于），同时您保留对业务流程至关重要的部分的控制权。您可以更轻松地 [允许其他人] 添加新的前端代码以解决新的细分市场，同时保持底层业务流程不会在流程中受到干扰的安全性/确定性。