yesno.wtf/api_WTF是API吗？

yesno.wtf/api

如果您是专业工作人员&＃xff0c;您可能已经听说过您的同事谈论过API &＃xff0c; Web服务 &＃xff0c; 端点以及其他一些奇怪的词&＃xff0c;例如200和401 。   这到底是什么意思&＃xff0c;它们之间有什么区别&＃xff1f;

什么是API&＃xff1f;

API或应用程序接口是使不同应用程序能够相互通信的东西。 Web服务是一种通过Internet进行通信的API。

通常&＃xff0c;当应用程序彼此通信时&＃xff0c; 请求和响应就会交换。

• 请求是要东西
• 响应是对请求的答案

• 

  App A向App B发送请求。AppB向App A发送响应。

  与现实生活中的要求类似&＃xff0c;您可能无法获得想要或期望的响应。 有时您成功了&＃xff0c;有时却没有成功。

  一个例子就是谷歌搜索。 当您在搜索引擎中键入内容并按Enter时&＃xff0c;它将执行API请求。 大多数情况下&＃xff0c;Google会返回包含数百万个结果的响应&＃xff0c;但有时它什么也找不到。

  正如我们将在下一节中看到的那样&＃xff0c;现代技术人员在谈论API时会使用一些特定的短语。 现在您也可以知道了&＃xff01;

  要求

  • “进行/触发API调用” &＃xff1a;发出请求。
  • “发出GET请求” &＃xff1a;发出获取数据的请求。
  • “发出POST请求” &＃xff1a;发出创建数据的请求。
  • “发出PUT请求” &＃xff1a;发出更新数据的请求。
  • “端点” &＃xff1a;网址&＃xff0c;例如&＃xff08; https://twitter.com/songthamtung &＃xff09;。
  • “命中端点” &＃xff1a;在指定的网址执行请求。

  响应

  • “ 200” &＃xff1a;成功的HTTP响应代码。
  • “ 301” &＃xff1a;重定向的HTTP响应代码。
  • “ 400”&＃xff1a;错误请求的HTTP响应代码。
  • “ 401 ”&＃xff1a;未经授权的HTTP响应代码。
  • “ 403”&＃xff1a;禁止的HTTP响应代码。
  • “ 404” &＃xff1a;未找到的HTTP响应代码。
  • “ 500” &＃xff1a;内部服务器错误的HTTP响应代码。
  • “ 504” &＃xff1a;超时的HTTP响应代码。

  认证方式

  • “ OAUTH”&＃xff1a;应用程序使用令牌授予权限的一种方式。
  • “令牌” &＃xff1a;一种身份验证形式&＃xff0c;类似于用户名/密码。
  • “刷新令牌” &＃xff1a;令牌可以并且确实会过期。 如果您收到401&＃xff0c;请考虑刷新您的API令牌。

  一般

  • “他们有API吗&＃xff1f;”&＃xff1a;他们的应用程序是否可以与我们的应用程序进行通信&＃xff1f;
  • “开放API” &＃xff1a;可供公众使用。
  • “封闭的API” &＃xff1a;不适用于公众。
  • “ API限制” &＃xff1a;某些API对在一定时间内可以发出的请求数量有限制&＃xff0c;例如&＃xff08;每天1000个请求&＃xff09;。
  • “ CRUD ”&＃xff1a;创建&＃xff0c;读取&＃xff0c;更新和删除。
  • “使用Postman测试” &＃xff1a; Postman是一个很棒的API开发工具。
  • “标题” &＃xff1a;说明要发送的数据的类型。
  • “正文” &＃xff1a;正在发送的数据。
  • “ GUID”&＃xff1a;用于唯一记录的全局唯一标识符&＃xff0c;例如&＃xff08;e20f5d52-5490-4523-87c5-af46dadfe7c1&＃xff09;。
  • “ JSON” &＃xff1a;一种数据格式&＃xff0c;以{“ key”&＃xff1a;“ value”}为特征
  • “ XML” &＃xff1a;一种以 value 为特征的数据格式
  • “ REST&＃xff08;ful&＃xff09;API” &＃xff1a;一种使用REpresentational State Transfer约束的API。
  • “ SOAP API” &＃xff1a;一种使用简单对象访问协议且基于XML的API。
  • “ GraphQL” &＃xff1a;API的查询语言。
  • “检查其文档” &＃xff1a;大多数API都有一个参考页面&＃xff0c;介绍了它的入门&＃xff0c;认证和支持的方法。

  结论

  技术人员喜欢使用技术词汇。 这样做并不是为了迷惑或排斥外界&＃xff0c;而是为了快速有效地交流思想&＃xff0c;问题和解决方案。

  与任何语言一样&＃xff0c;您可以组合单词以形成有意义的句子&＃xff1a;

  “是&＃xff01; API响应返回200&＃xff01;”

  “尝试创建一个新用户。 点击用户端点并发出POST请求”

  希望您现在能够理解上面的两个句子。 乍看之下&＃xff0c;技术领域的白手起家似乎令人生畏&＃xff0c;但随着时间和实践的发展&＃xff0c;它将开始成为第二自然。

  如果您有其他关于API的交流方式&＃xff0c;或者对上面的示例有任何疑问&＃xff0c;请在下面留言以告知我。

  谢谢阅读&＃xff01; 最初发布在A Cloud Guru上 。

翻译自: https://hackernoon.com/wtf-is-an-api-ry63h32bs

yesno.wtf/api