为十年后的读者写
判词、schema 注释、台账记录,都要让一个已经忘记这一周的人读懂——包括作者本人。记录为什么,而不只是记录什么。
[ yApis // V.0.2.7 ]
SYNC // --:--:--Z
外部 API 的登记簿与试验场
Best APIPlayground
每一个经手的第三方服务与公开数据源,
各有一份 typed probe 与一句判词。
11登记条目
2probe 已跑绿
2试验场页面
3分类轴,亦是上限
01 / 04入库工序
一条 API,
三道工序。
yApis 把「用过」变成可复核的记录。入库的门槛是跑通,不是收藏。选择一道工序,查看它落盘的文件、守住的约束,以及它在何处失败过。
CONTRACT / 01 契约生效
以真实响应校验
Schema
schema 记录的是响应实际的形状,而不是文档承诺的形状。字段是否可空由样本决定:Openverse 聚合上游来源,几乎每个字段都可空;Wallhaven 的 meta.query 在精确 tag 搜索时从字符串变为对象。每一个 optional 都是证据,不是保守。
100%样本经 schema 校验
- 01以真实响应定型
- 02optional 即证据
- 03sample.json 冻结
02 / 04登记簿
一条登记,
一句判词。
厂商、计费、鉴权、配额,以及一句无法从文档重新推出的判断——判词以它被学到时的语言写就,不作翻译。点选一行,查看这条登记的字段。
11 条登记2 条已探测
入册API · 厂商成熟度鉴权
INSPECT / wallhaven
slug::wallhaven kind::data pricing::free auth::optional-key probe::probes/wallhaven.mts lab::/apis/wallhaven adopted_by::yAssets 打开试验场
03 / 04运行原则
一份写给整个职业生涯的登记簿。
入册门票保持昂贵
一条经 probe 复核、带判词的登记,胜过五十条粘贴的书签。增长的压力从不构成降低门槛的理由——这是它与会腐烂的链接列表之间唯一的区别。
分类纪律会复利
三根轴是上限:status、kind、pricing。行业领域是 tag 而不是轴,因为它的值域没有尽头。十一条时任何结构都可行;三百条时,只有抵住了维度蔓延的那一个还可行。