本页面由英文翻译而来。
开发者工具
构建API测试与调试工具
Kliv是一个AI应用构建平台。描述你的团队需要的API测试与调试工具——保存请求、定时探测、响应对比、事故记录和合作伙伴权限墙——它就会为你构建出来。
只需在文本框中输入你的想法,AI 就会为你构建它
什么是 Kliv?
Kliv不是桌面API客户端,也不是共享请求集合服务——它是一个能为你构建软件的AI。
你用平实的语言描述所需的应用,Kliv就会构建数据库、业务逻辑、界面、定时任务和权限规则。构建完成后应用归你所有,之后可以通过提出修改要求来调整。这不是一个模板工作区。
在这个页面中,这个应用是一个API测试与调试工作台。Kliv能构建各种网页应用;这一个能帮助团队记住请求、运行探测、对比响应,并让事故记录始终有据可查。
共享请求集合为何撑不住
每台笔记本电脑上装一个API客户端,对一个集成、两名工程师来说或许够用。但当合作伙伴的API越来越多、团队成员分布在不同时区、客户追问故障究竟出在你的代码还是合作伙伴的变更时,这种方式就不再管用了。
Kliv把这个工作台构建成一套记录系统。每一个接口、每一条保存的请求、每一次探测结果、每一份响应对比和每一起事故,都是共享数据库中的一行记录,拥有权限管理和历史记录,不会随某个人的笔记本电脑而消失。
一条请求背后的组成部分
五种记录把一条保存的请求变成一套调试流程。
接口记录
按环境划分的基础URL、认证方式、合作伙伴联系人,以及你维护的变更日志。请求和事故都挂靠在这条记录之下。
保存的请求
请求头、请求体,以及诸如预期状态码、预期响应结构、延迟上限之类的断言。一旦有了断言,一条请求就变成了一项测试。
探测计划
服务端函数按计划重放保存的请求,比如每十五分钟对预发布环境探测一次、每小时对生产环境探测一次。断言失败就会开启一起事故。
事故
一起事故保留响应对比、时间线、受影响的商户,以及通知了谁、何时通知的记录。
合作伙伴权限墙
工程师只能看到分配给自己的合作伙伴。客户状态视图只显示自己的集成情况,看不到其他信息。
示例:陈静的物流集成团队
以下是一个团队如何使用Kliv构建的API测试工作台的例子。这只是一个示例——你可以描述自己的合作伙伴、请求、环境、断言和事故规则。
合作伙伴悄悄改动了响应
一家快递公司在预发布环境上线新版本,请求头里的版本号从2.13变成2.14。快递公司既没有发邮件,也没有更新变更日志。
定时探测发现了结构变化
陈静的探测发现物流跟踪的响应体多了一个字段,又少了一个字段。接口仍然返回200,但结构断言失败了。
事故随附对比记录一起开启
受影响的商户直接从数据中确定——因为只有两家商户通过这家快递公司发货。严重程度不用靠猜测。
团队并排重放预发布和生产环境
周一,同一条保存的请求在一个视图里分别跑向两个环境。改动范围一目了然,修复方案是更新映射,整个排查过程都停留在同一个界面上。
客户看到的是范围受限的时间线
商户能看到自己的事故页面:发生了什么变化、团队何时得知、采取了什么措施。看不到其他商户的集成情况。
描述你想要的API工作台
Kliv根据你的描述进行构建,所以请包含合作伙伴、环境、计划、断言、事故规则,以及谁能看到什么。细节越丰富,第一版就越贴近你的需求。
快递公司API工作台
为物流合作伙伴保存请求、运行探测并管理事故。
“为我们的物流集成构建一个API测试工作台。按快递公司保存请求,存储预发布和生产环境的基础URL,每15分钟对预发布环境运行一次探测,每小时对生产安全的请求运行一次探测,断言状态码为200、必需的跟踪字段齐全、延迟低于800毫秒,并在断言失败时开启包含完整响应对比和受影响商户的事故。”
支付沙盒监控
在上线前监控支付合作伙伴。
“构建一个支付API监控工具,每小时对沙盒环境重放我们保存的授权、扣款、退款和webhook验证请求。断言响应结构、状态码,以及延迟低于500毫秒,任何断言失败时都开启带对比记录的事故。”
客户状态门户
让每个商户拥有自己的集成历史记录。
“构建一个客户状态门户,让每个商户登录后只能看到自己集成的正常运行时间、事故和探测历史。事故开启、状态变化或解决时发送邮件通知。”
控制台之下
探测是定时任务。 每个探测都是一个按cron计划运行的服务端函数。它重放保存的请求,评估断言,并把结果写成一行记录。
合作伙伴密钥留在服务端。 沙盒和生产环境的密钥由平台存储,在运行时注入。它们不会出现在导出的请求集合、笔记本电脑或wiki里。如果你把环境分开标记,预发布探测就无法使用生产环境的密钥运行。
权限墙是数据规则。 一名工程师如果被限定只能看两家快递公司,他从同一批数据表里取到的也只是这两家的数据。客户看到的是自己的状态视图。隐私规则在数据返回之前就已生效。
因为这是一个真正的应用,它还能不断增加客户可用的功能:商户状态页面、每周探测摘要,以及一个能从你自己的事故历史中回答“费率接口上次是什么时候变更的?”这类问题的智能体。
Kliv在构建过程中也会编写测试,并可以在测试通过之前暂缓发布。测试页面详细介绍了这套流程。
常见问题
Kliv究竟是什么?
Kliv是一个AI应用构建平台。你描述需要的API测试流程,它就会构建一个包含保存的请求、探测计划、事故、响应对比和范围受限视图的真实应用。
我得到的是真正的应用,还是一个模板?
是真正的应用。你的接口、断言、计划、环境、事故和权限规则都存储在为你的工作流程构建的数据库中。
构建完成后还能修改吗?
可以。你可以用平实的语言提出修改要求,添加合作伙伴、断言、计划、事故字段、客户视图或新的环境。
探测可以在生产环境运行而不造成损害吗?
可以。你可以标记哪些保存的请求对生产环境是安全的。写操作类的请求可以固定只在预发布环境运行,并且每个环境都有自己的密钥。
客户能看到这个工作台吗?
他们能看到一个范围受限的视图:自己的集成情况、事故、正常运行时间和探测历史。工程师保留完整的控制台。
凌晨3点断言失败时会发生什么?
系统会创建一起附带响应对比的事故记录。邮件或Slack可以通知值班工程师,探测会继续运行,以便记录恢复情况。
我们能导入现有的请求集合吗?
可以。保存的请求就是数据。导入之后,它们会拥有计划、断言、事故和权限规则,而不再只是笔记本电脑上的文件。
它能安全地存储密钥吗?
API密钥保留在服务端,在探测运行时注入。它们不需要随请求定义一起导出。
我能使用自己的域名吗?
可以。内部控制台和客户状态视图都可以运行在你自己的域名上。
以后我能离开Kliv吗?
可以。应用的代码会同步到你自己的Git仓库,离开时只需git pull,而不用重新构建。
我需要单独的事故管理工具吗?
不需要,至少这里描述的工作流程不需要。事故可以和探测、对比记录、客户可见的时间线放在同一个应用里。
创作者构建
探索可能性
查看全球开发者和创作者使用 Kliv 构建的真实应用
Memory Café Coordination Tool
A warm platform for dementia-friendly cafés, connecting caregivers, volunteers, and coordinators.
Remit Record
Track remittances and household budgets seamlessly.
Next Page Book Club
Manage your book club easily with proposals, voting, and history tracking.
Northfern Tattoo Studio
Portfolio and booking site for Northfern Tattoo Studio.
Campo Agua Gestión
Sistema de gestión del agua comunitario para aldeas.
つくりて — 伝統工芸職人サイト
職人が作品を展示し、受注管理を行うサイトです。
Tidal Surf Reports
Crowd-sourced surf condition tracking app.
Riverside Commons HOA Management
A portal for HOA management at Riverside Commons.
よやくん — レストラン予約管理
小規模レストラン向けの予約管理サイトです。
Troop 214 Scout Management
A management tool for Scout Troop 214, focused on outings, advancement, and communication.
Te Kura Kaupapa Māori Whānau Board
A whānau coordination tool for Māori-medium schools.
Tsev Nyeem Ntawv Library
Mobile library coordinator for Hmong and Lao communities.
Memory Café Coordination Tool
A warm platform for dementia-friendly cafés, connecting caregivers, volunteers, and coordinators.
Remit Record
Track remittances and household budgets seamlessly.
Next Page Book Club
Manage your book club easily with proposals, voting, and history tracking.
Northfern Tattoo Studio
Portfolio and booking site for Northfern Tattoo Studio.
Campo Agua Gestión
Sistema de gestión del agua comunitario para aldeas.
つくりて — 伝統工芸職人サイト
職人が作品を展示し、受注管理を行うサイトです。
Tidal Surf Reports
Crowd-sourced surf condition tracking app.
Riverside Commons HOA Management
A portal for HOA management at Riverside Commons.
よやくん — レストラン予約管理
小規模レストラン向けの予約管理サイトです。
Troop 214 Scout Management
A management tool for Scout Troop 214, focused on outings, advancement, and communication.
Te Kura Kaupapa Māori Whānau Board
A whānau coordination tool for Māori-medium schools.
Tsev Nyeem Ntawv Library
Mobile library coordinator for Hmong and Lao communities.
在客户发现之前先发现版本变更
描述你的团队如何测试API——合作伙伴、请求、探测、断言和权限墙。Kliv会构建一个能记住这一切的工作台。