API到底是什么？

如果你是一名职场人士，你可能听过同事们谈论API、Web 服务、端点以及其他一些奇怪的词汇，比如200和401。它们到底是什么意思？它们之间又有什么区别呢？

什么是API？

应用程序编程接口（API）是一种使不同应用程序能够相互通信的机制。Web服务是一种通过互联网进行通信的 API。

通常情况下，应用程序之间进行通信时，会进行请求和响应的交换。

• 请求是指要求某事。
• 响应是对请求的回答。

就像在现实生活中提出请求一样，你可能不会得到你想要或预期的回应。有时你会成功，有时则不会。

举个例子，比如用谷歌搜索。当你在搜索引擎中输入内容并按下回车键时，它会发出一个 API 请求。大多数情况下，谷歌会返回数百万条结果，但有时却找不到任何内容。

正如我们将在下一节中看到的，现代技术人员在谈论 API 时会使用一些特定的术语。现在，您也可以了解这些术语了！

请求

• “发起/触发 API 调用”：发出请求。
• “发出 GET 请求”：发出请求以获取数据。
• “发出 POST 请求”：发出创建数据的请求。
• “发出 PUT 请求”：发出更新数据的请求。
• “端点”：网址，例如（https://twitter.com/songthamtung）。
• “访问端点”：向指定的 URL 执行请求。

回复

• “200”：HTTP 响应代码，表示成功。
• “301”：重定向的 HTTP 响应代码。
• “400”：HTTP 错误请求的响应代码。
• “401”：HTTP 响应代码，表示未授权。
• “403”：HTTP 响应代码，表示禁止访问。
• “404”：HTTP 响应代码，表示“未找到”。
• “500”：HTTP 内部服务器错误的响应代码。
• “504”：HTTP 超时响应代码。

验证

• “OAUTH”：一种应用程序使用令牌授予权限的方式。
• “令牌”：一种身份验证形式，类似于用户名/密码。
• “刷新令牌”：令牌会过期。如果您收到 401 错误，请考虑刷新您的 API 令牌。

一般的

• “他们有API吗？”：他们的应用程序是否有办法让我们的应用程序与之通信？
• “开放API”：可供公众使用。
• “封闭式 API”：不对公众开放。
• “API 限制”：某些 API 对您在特定时间内可以发出的请求数量有限制，例如（每天 1000 个请求）。
• “CRUD”：创建、读取、更新和删除。
• “用 Postman 测试一下”：Postman 是一款非常棒的 AP​​I 开发工具。
• “头部”：说明所发送的数据类型。
• “主体”：正在发送的数据。
• “GUID”：全局唯一标识符，用于区分记录，例如（e20f5d52–5490–4523–87c5-af46dadfe7c1）。
• “JSON”：一种数据格式，其特点是{"key":"value"}
• “XML”：一种以值为特征的数据格式
• “REST（ful）API”：一种使用表述性状态转移约束的 API 类型。
• “SOAP API”：一种使用简单对象访问协议且基于 XML 的 API 类型。
• “GraphQL”：一种用于 API 的查询语言。
• “查看他们的文档”：大多数 API 都有一个参考页面，介绍入门、身份验证以及它支持的方法。

结论

技术人员喜欢使用专业术语。这并非为了迷惑或排斥外行人，而是为了快速有效地传达想法、问题和解决方案。

和其他语言一样，你可以将词语组合起来构成有意义的句子：

• “是的！API 响应返回了 200！”
• “尝试创建一个新用户。访问用户端点并发送 POST 请求。”

希望你现在能够理解上面两句话。科技领域的行话乍听起来可能有些晦涩难懂，但随着时间和练习，你会逐渐习以为常。

如果您有其他关于 API 的沟通方式，或者对以上示例有任何疑问，请在下方留言告诉我。

感谢阅读！原文发表于A Cloud Guru 网站。