共计 2346 个字符，预计需要花费 6 分钟才能阅读完成。
摘要 ：程序猿小 Hi 入职公司不到三个月，就被老板独自叫到了办公室……
初创公司 R：刚刚创建，致力于通过信息化技术，帮忙中小企业数字化转型，富丽转身。
公司成员：老板、程序猿小 Hi、… …
程序猿小 Hi 入职公司不到三个月，就被老板独自叫到了办公室。小 Hi 情绪既冲动又不安，冲动的是老板是不是要给本人升职加薪，不安的是不是本人体现不好，老板要炒鱿鱼，毕竟疫情是一个很好的借口。
来到了老板的办公室，不等小 Hi 谈话，就单刀直入，说：小 Hi 啊，你来公司挺长时间了（还没到三个月，老板健忘？），你的工作做得挺好（心里开始爽歪歪），明天有个重要工作要交给你（凉了一半，升职加薪忘了吧）。
小 Hi：好的，老板你有啥就间接嘱咐，保障高效实现（心里开始有点忐忑）。
老板：昨天有个新客户，提了个需要，他们是在 XX 高新区，公司多切人员杂，在目前疫情状况下，想在门岗处减少门禁，辨认外来人员，增强疫情管控。这是他们的需要文档，公司的其他人都出差了，这个工作就交给你了。记住，要做成模块化，不便后续客户利用。
小 Hi：是，老板，我好好看看他们的需要文档。
……
小 Hi 来到老板办公室，关上需要文档一看，六个大字映入眼帘：咱们要人脸识别（不对，是七个），心里翻滚着五味杂陈，“模块化”和“人脸识别”，这就是需要。
第一次接到了老板的工作，小 Hi 陷入了“沉思”（吃鸡游戏中…）
第一个需要是“模块化”，模块化就是要求封装外部细节，精简对外交互，实现高内聚低耦合。小 Hi 第一工夫就想到了通过提供 API 来保障本身的独立性，以及清晰化的对外交互界面，大学里学的那点 API 相干的常识开始在脑海里爆发：
API 的定义：
利用程序接口（Application Programming Interface）是一组定义、程序及协定的汇合，通过 API 接口实现计算机软件之间的互相通信。用来提供应用程序与开发人员基于某软件或硬件得以拜访的一组例程，而又无需拜访源码，或了解外部工作机制的细节。
常见的 API 类型有：
1）RESTful API： 基于 HTTP、URI 和 XML 等的常见的 Web 服务接口标准，形容了一个架构款式的网络系统，其外围是面向资源的。
2）SOAP 接口： 简略对象拜访协定，简略对象拜访协定（SOAP）是一种轻量的、简略的、基于 XML 的协定，它被设计成在 WEB 上替换结构化的和固化的信息。
3）RPC 接口： 近程过程调用 (RPC) 是一种协定，程序可应用这种协定向网络中的另一台计算机上的程序申请服务。
4）RMI 接口： 近程办法调用 RMI 是针对于 java 语言的，RMI 容许您应用 Java 编写分布式对象。
API 的设计准则，好 API 的 6 个特质：
1）极简： 极简的 API 是指对外裸露的尽可能少，这样的 API 更易了解、记忆、调试和变更。
2）齐备： 齐备的 API 是指用户冀望有的性能都蕴含了，满足用户的需要，是齐备的。
3）语义清晰简略： 接口、参数、帮忙等的语义清晰简略，应用常用语和缩略语，不实用生僻语，尽量减少意外。
4）合乎直觉： 教训不很丰盛的用户不必浏览 API 文档就能搞懂 API，而且程序员不必理解 API 就能看明确应用 API 的代码。
5）易于记忆： 为使 API 易于记忆，API 的命名约定应该具备一致性和精确性。应用易于辨认的模式和概念，并且防止用缩写。
6）疏导 API 使用者写出可读代码： 代码只写一次，却要屡次的浏览（还有调试和批改）。写出可读性好的代码有时候要花费更多的工夫，但对于产品的整个生命周期来说是节俭了工夫的。
注：源自 Qt 的 API 设计准则，_详见__https://github.com/oldratlee/translations/blob/master/api-design-principles-from-qt/README.md_
API 相干概念
1）API 网关： 服务与服务之间通信的中介或桥梁，提供服务接入和鉴权、API 注册、流控、治理等 API 托管服务。
2）API 全生命周期治理： 笼罩了 API 的设计、开发、测试、公布、订阅、应用和剖析的端到端、全流程的治理。
第二个需要是“人脸识别”，小 Hi 没有 AI 相干技术积攒，开始捉急，突然灵光一闪，想起来前两天华为云专家过去交换，有提到华为云的 AI 能力，于是冲动的关上了浏览器。
输出 https://www.huaweicloud.com/，关上华为云，抉择“开发者”=>“资源工具”下的 API Explorer，查看华为云所有凋谢 API：
在 API Explorer 下面，能够疾速查看对应云服务的凋谢 API：
在搜寻框输出人脸识别，搜寻相干的云服务：
关上人脸识别服务，有人脸比对、人脸检测、人脸搜寻、人脸资源管理、人脸库资源管理等，挺多 API 的，太棒了。
急不可待调试一把，登录华为云（没注册的连忙注册下），抉择到人脸识别控制台页面（https://console.huaweicloud.c…），开明人脸比对服务：
在 API Explorer 上抉择人脸比对 API（FaceCompareByFile），查看此 API 具体介绍信息，包含接口阐明、申请参数、示例、返回参数、错误码等，此 API 反对比照两张人脸图片信息，判断是否同一个人的置信度：
咱们间接能够抉择要比对的图片，在 API Explorer 上点击调试按钮来在线调试这个 API：
点击调试后，能够失去比对后果，类似度 94.699%（代表同一个人的概率很大）：
再调试了多个 API 接口，查阅了人脸识别服务介绍后，小 Hi 心里有着落了，一张“蓝图”在脑海中绘制：
小 Hi 登时信念爆棚起来，这下能够在老板背后好好体现下了。
你认为这就完结了吗？
图样图森破，小 Hi 还是太年老，按以往教训，蓝图和落地至多还差个河汉的间隔，期待小 Hi 的是怎么疾速实现这个公共服务，未完待续 ……
点击关注，第一工夫理解华为云陈腐技术~
