知识卡片
接口规范显式描述服务契约
Swagger/OpenAPI在本书中用于以机器可读格式表达REST服务接口,帮助协作方了解可发送和接收的信息。它把分散在实现或惯例中的约定显式化,适合服务数量增长后的接口协作;本节未说明具体版本、全部规范字段或如何自动证明业务正确。
可联系[[机器可读契约支持跨团队协作]]理解条件与边界。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 1.服务契约
原书出处 · 1 处
- · 查看原书依据
比如,REST API可以使用Swagger/OpenAPI。
参考来源
- 位置:《微服务实战》第2章《SimpleBank公司的微服务》(来源项目book-sources;extracted/微服务实战/_epub-src/text/part0011_split_003.html;src-052)。
- 结论依据:正文给出REST接口标准化用途,不补充未经本节介绍的规范能力。
- 原始内容:比如,REST API可以使用Swagger/OpenAPI。