乐于分享
好东西不私藏

前天客户要接口文档 今天,企业 API 已经能联调了

前天客户要接口文档 今天,企业 API 已经能联调了

前天客户要接口文档 今天,企业 API 已经能联调了

2026-07-22 · 产品动态 · 域名切换 + 企业 API 初版兑现

项目群里有一句很「催人」的话:

「咱这边看一下后续怎么对接,能不能给出接口文档。」

我们一开始还想按老习惯:先把效果测明白,再谈正式对接。结果客户认真了——我们也只好把节奏提上来。

项目群:客户提出对接需求

一、三天时间线

  • 前天
    :提出对接 / 要接口文档
  • 昨天
    :回复「API 版本接口预计明天,最迟后天能测」
  • 今天
    :注册开户、签发测试密钥、联调跑通;客户反馈「简单测试一下,没什么问题
今日:注册联调,客户反馈没什么问题

二、企业 API 初版里有什么

控制台目前开放这些能力(初版):

  1. 对接说明
    :鉴权方式、WebSocket 连接、提交任务、服务端推送事件、结果字段说明
  2. API 联调 Playground
    :连接 → accepted → start → progress / final 的完整流程演示
  3. API 密钥
    :由平台管理员签发(页面仅查看前缀,不支持自助生成)
  4. 调用统计
    :月成功次数已统计;明细列表仍在打磨,后续补齐
API 联调 Playground:连接 → 提交 → 进度 → 结果
对接说明:鉴权方式与 WebSocket 连接
联调小提示:
浏览器侧 WebSocket 不好带鉴权 Header,建议在服务端联调,或直接用控制台 Playground 走通流程。密钥请勿提交到代码仓库,也不要发到群聊明文区。

三、顺带一提:域名切换

今天同步完成站点切换:

  • 2.0 新版本
    :正式域名已切换到 www.qlyoncut.com
  • 1.0 旧版本
    :改至 v1.qlyoncut.com,保留至 7 月 31 日

收藏夹里还是旧地址的朋友,月底前迁移一下,避免突然打不开。

2.0 新版本首页(移动端)

四、算法侧的一点进展

昨天刚补的一类多规格场景之外,困难用例对照里也出现了一些「少用板」的突破,覆盖面还在继续扩。产品仍坚持一句实话:不是所有场景都宣称最优,而是一块块把短板补上。

困难用例对照:算法覆盖面继续扩大

五、接下来

  • 补齐「每个字段」级别的接口说明(客户已点名要)
  • 调用统计明细对接
  • 继续扩大算法适用边界

做系统集成、想进联调的朋友,后台回复 API 或 联调,我们拉你进流程。

权亮 · QlyonCut 产品动态 · 欢迎转发同事