Swagger 接口文件，用于 Vault API，详细说明见 此处 和 此处。

这并未规范整个 API，只是那些我们感兴趣的。

构建客户端/服务器库

使用 swagger-codegen。

或者，运行 make 来构建 Rust Crates。

已知问题

Swagger 2.0 规范并不完全适合此 API

1. Swagger 规范不允许任意路径，因此无法在不进行大量繁琐操作的情况下规范以下路径：

• /secret/secret-1
• /secret/foo/secret-2
• /secret/foo/bar/secret-3

2. Swagger 规范不允许使用查询参数切换到逻辑上不同的端点，例如以下每个都有不同的响应类型：

• /secret/foo
• /secret/foo?list=1
• /secret/foo?help=1

此外，现有的 Rust 实现 swagger-codegen 不支持此处所需的所有功能。请参阅

• https://gitlab.datcon.co.uk/orchestration/vault-schema/issues/1