配置

Config 是 Hola.Cloud 生态系统中的小型 JSON 配置 API。它存储配置条目,并允许已认证用户读取或更新运行时配置。

关键优势

基于条目的配置

v0 API 将配置存储为包含 identries 的 Thing。v1 用户 API 将当前用户配置返回为 entries 映射。

基于 JSON

所有配置都存储为 JSON 文档,易于读写,并能与任何编程语言或工具链集成。模式灵活,您可以存储任何有效的 JSON 结构。

简单更新

更新会替换或修补 API 接受的条目数据。

易于集成

Config 可与 Hola.Cloud 生态系统中的其他服务(如 InceptionDB、Lambda 和 InstantLogs)无缝集成。在服务之间集中配置可减少重复工作,并保持基础设施的一致性。

安全访问

该服务提供两个 API 接口。v0 API(/v0/configs)管理配置 Thing。v1 用户 API(/v1/config)需要 X-Glue-Authentication,用于读取或更新已认证用户的运行时配置。

API 概览

方法 路径 描述 认证
GET /v0/configs 列出所有配置(管理) 公开
POST /v0/configs 创建新配置(管理) 公开
GET /v0/configs/{id} 根据 ID 获取配置(管理) 公开
DELETE /v0/configs/{id} 删除配置(管理) 公开
PATCH /v0/configs/{id} 部分更新配置(管理) 公开
GET /v1/config 获取当前用户配置 entries 映射 Glue 认证
PATCH /v1/config 更新当前用户配置 entries 映射 Glue 认证

基础 URL:https://api.hola.cloud

最佳使用场景

运行时配置

在启动时或运行期间从 /v1/config 获取已认证用户的配置。

功能开关

将功能开关存储为配置项,并在运行时更新而无需修改代码。

评论

发表评论