keji.icu · 接口服务

克己API

克己,是分寸感。接口如此,用量如此。

面向开发者与小型团队的轻量接口服务,把日常反复出现的文本处理、结构化解析与单位换算,整理成稳定、可预期的 HTTP 接口。

统一 JSON 响应 固定限流窗口 脱敏调用日志
关于本站

关于克己API

克己API 是一个由个人独立维护的接口服务站点,域名 keji.icu,维护者郑宗杰。站点把开发中反复出现的几类小需求——文本清洗、结构化数据解析、单位与编码转换——封装成可复用的 HTTP 接口,调用方不必为一件小事引入整套依赖,也不必自己维护一堆解析脚本。

名字里的「克己」讲的是边界感:接口只做约定范围内的事,不越界采集数据,不擅自改动返回结构,也不在未说明的情况下调整限流阈值。每一次响应都尽量保持可预测,调用方才能安心地把它放进自动化流程。

能力范围

接口能力

文本处理

统一空白与标点、切分句子、提取关键词,适合日志整理,也适合把杂乱的抓取结果整理成可读段落。

结构化解析

把常见的结构化文本转换成干净的 JSON;字段缺失时返回明确的空值,而不是静默丢失,方便下游代码判断分支。

单位换算

时间戳、时区与常用计量单位之间的换算,按固定精度返回结果,避免不同语言与库实现带来的细微误差。

使用方式

接入流程

  1. 申请密钥说明用途与预估调用量,获得独立签发的访问密钥。
  2. 确认约定核对请求地址、参数含义、错误码与限流阈值,再决定重试策略。
  3. 发起调用以 HTTPS 提交请求,响应统一为 JSON,出错时同样返回机器可读的状态字段。
  4. 观测用量按日核对调用次数与失败率,接近阈值时提前联系调整。
运行方式

稳定与边界

克己API 以固定窗口统计调用次数,超出阈值的请求返回 429 与建议的重试间隔;服务端为每次调用保留脱敏日志,只记录接口路径、状态码与耗时,不记录业务内容本身。接口版本通过路径区分,旧版本在公告期结束前持续可用,避免升级打断线上流程。

JSON统一响应结构
429限流与重试提示
HTTPS传输全程加密
联系与核验

取得联系

如需接入,可写信至 admin@keji.icu,说明用途与调用规模,通常两个工作日内回复。站点不发放公开的试用密钥,所有密钥按用途单独签发,出现异常时可快速定位与停用。主体信息可在页面底部的备案号处核验。