知识卡片
用元数据汇集API资产
接口的文档、安全、定义和维护信息散落时,消费者难以完整发现可用资产。
API元数据文档集中列出名称、入口、说明、定义文件、工具、共同属性与维护者,使消费者可发现操作所需资产。书中采用APIs.json,并以rel="service-meta"和/apis.json公布位置。
这份目录描述接口周边信息,不负责完整定义接口;具体契约仍应链接OpenAPI等SDD。可通过properties.type加入安全、限流、状态页等资产,也可扩展,但必须保持兼容。书中的APIs.json版本及搜索引擎状态属于2022年背景。
关联:[[公开服务定义入口]]。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 超媒体服务 · 查看原书依据
A very dependable way to catalog and publish API metadata is to use the APIs.json open specification. It has a vocabulary and structural layout that covers most of the important metadata elements for APIs (basic definitions, properties of the API, important URLs, key contacts and maintainers, etc.). It is also extensible so API providers can, when needed, expand the APIs.json document (in a backward-compatible way) to fit their needs.