如果您是一个专业的工作人员,您可能已经听说过您的同事谈论过API , Web服务 , 端点以及其他诸如200和401之类的怪异单词。 这到底是什么意思,它们之间有什么区别?
什么是API?
API或应用程序接口是使不同应用程序能够彼此通信的东西。 Web服务是一种通过Internet进行通信的API。
通常,当应用程序彼此通信时, 请求和响应就会交换。
- 请求是要东西
- 响应是对请求的答案
App A向App B发送请求。AppB向App A发送响应。
与现实生活中的要求类似,您可能无法获得想要或期望的响应。 有时您成功了,有时却没有成功。
一个例子是谷歌搜索。 当您在搜索引擎中键入内容并按Enter时,它将执行API请求。 在大多数情况下,Google会返回包含数百万个结果的响应,但有时无法找到任何东西。
正如我们将在下一节中看到的那样,现代技术人员在谈论API时会使用一些特定的短语。 现在您也可以知道了!
要求
- “进行/触发API调用” :发出请求。
- “发出GET请求” :发出获取数据的请求。
- “发出POST请求” :发出创建数据的请求。
- “发出PUT请求” :发出更新数据的请求。
- “端点” :URL,例如( https://twitter.com/songthamtung )。
- “命中端点” :在指定的网址执行请求。
响应
- “ 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是一个很棒的API开发工具。
- “标题” :说明要发送的数据类型。
- “正文” :正在发送的数据。
- “ GUID”:用于唯一记录的全局唯一标识符,例如(e20f5d52–5490–4523–87c5-af46dadfe7c1)。
- “ JSON” :一种数据格式,以{“ key”:“ value”}为特征
- “ XML” :一种以<tag> value </ tag>为特征的数据格式
- “ REST(ful)API” :一种使用REpresentational State Transfer约束的API。
- “ SOAP API” :一种使用简单对象访问协议且基于XML的API。
- “ GraphQL” :API的查询语言。
- “检查其文档” :大多数API都有一个参考页面,介绍了它的入门,身份验证和支持的方法。
结论
技术人员喜欢使用技术词汇。 这样做并不是为了迷惑或排斥外界,而是为了快速有效地交流思想,问题和解决方案。
与任何语言一样,您可以组合单词以形成有意义的句子:
“是! API响应返回200!”
“尝试创建一个新用户。 点击用户端点并发出POST请求”
希望您现在能够理解上面的两个句子。 乍看之下,技术领域的白手起家似乎令人生畏,但随着时间和实践的发展,它将开始成为第二自然。
如果您有其他关于API的交流方式,或者对上面的示例有任何疑问,请在下面留言以告知我。
谢谢阅读! 最初发布在A Cloud Guru上 。