Appearance
数据 API
KMS 主系统本身并不提供数据访问服务,提供数据访问服务的是 KMS 的一个子系统,称之为 Data API。当 KMS 保存的数据发生变化时,KMS 主系统会将数据变化通知给 Data API,而 Data API 负责对外提供数据访问服务。
Data API 是独立运行和提供服务的。
基本概念
- API Key :一组数据使用同一个 key 标注,同时作为 API 访问时的索引,它是一个由 KMS 生成的随机字符串,在同一个项目内保持唯一,无法修改也无法指定
- API Alias :为了人为可读性,为 API Key 设置的别名,同样保持项目内唯一
- Data SN : 一组数据中包括多条数据项,每个数据项都有一个序列号 SN,该 SN 保持在同一个 API Key 下唯一,它是一个时序字符串,无法修改也无法指定
定位一条数据项需要使用 API Key + SN 或者 API Alias + SN 方式。API Alias 可以随时修改,而 API Key 和 Data SN 则无法修改,也无法指定。
接口定义
Data API 对公网开放,有自己独有的域名,功能只有一个:数据查询服务。点击查看具体的 API 定义。
动态子域名
KMS 支持多租户,并通过动态子域名给不同的项目分配不同的子域名。而 Data API 也是支持多租户的,同样通过动态子域名区分不同的项目。而两个系统对应同一个项目的子域名是完全相同的。
比如,活动专题项目的 KMS 域名是 activity.kms.seayoo.com
那么对应的 Data API 域名是 activity.dsi.seayoo.com