API开发

关于API开发的文章、指南和教程,为开发者和企业提供实用知识与技巧。面向开发者与技术团队。

AI 智能体支付:智能体商务对商家意味着什么

AI 智能体支付在大约一年之内产生了四份彼此竞争的规范、两个行业基金会,以及海量的报道。它还没有为绝大多数商家产生的,是收入。噪音与数字之间的落差才是值得理解的部分,因为兴奋的报道和轻蔑的报道都以让人赔钱的方式弄错了。 确实有真东西正在被建造。Google、OpenAI、Stripe、Coinbase、Shopify、Visa 和 Mastercard 都在这个领域交付了规范或产品,其中两份规范如今归属于中立的基金会,而不是单一厂商。其中一部分已经在生产环境中运行。但生产环境里的大部分流量,是机器向另一台机器购买 API 调用,而不是购物助手向你买一张沙发。 本文把已经交付的东西与只是挂了一排徽标的规范区分开,说明你的结账流程和风控...

Salesforce 集成:API 配额、设计取舍与真实成本

Salesforce 集成几乎从来不是败在协议上。认证是已经解决的问题,写入一条记录也是已经解决的问题。真正把项目拖垮的,是每天的请求配额和数据模型的形状,而这两件事通常要等到上线大约三周之后才被发现,那时夜间作业开始返回错误,却没有人说得清它在测试环境里为什么是好的。 这个模式一致到可以预测。开发者对着一个 Developer Edition 组织开发,一切通过,客户签字验收。随后这套代码遇上的,是一个已经住着营销连接器、数据仓库抽取作业和一个 2019 年就在跑的 Apex 触发器的生产组织,而那份看起来很宽裕的请求预算,其实是别人早已在花的一口共用的锅。 这篇文章把意外提前摊开来讲:你应该用哪个 API、配额是怎么算的、当你的...

密码存储:2026 年该用什么

密码存储是软件里少数几个真正存在标准答案的领域之一。答案早就公开了,一直有人维护,而且免费。可它同时又是最经常被做错的领域之一,原因很简单:那些错误的做法在某个年代确实是正确的,而后来没有人再回头看过一眼。 失败的样子很少稀奇。通常就是一套 2016 年按照 2012 年的建议搭起来的系统,到今天还在跑,还在接受登录请求,而自从当初写下那段哈希代码的人离职之后,就再也没有人打开过那个函数。它没出过故障,也没被审计过,所以从来不在任何人的待办清单上。 如果只带走一句话:用 Argon2id,实在不行就用 bcrypt。 本文其余部分都是细节。像 SHA-256 这样的通用哈希函数,无论你把它套用多少次,都不是密码哈希。它的快是设计目...

API 版本管理:何时该破坏,以及如何不破坏

关于 API 版本管理的争论,几乎总是从错误的一端开始:版本号该放在哪里。其实这是整个话题里后果最轻的一个决定。真正要紧的是,究竟哪些变更才需要一个新版本,而大多数团队恰恰在这里判断失误,而且是往掉以轻心的方向失误。他们发布了自认为纯属新增的东西,然后某个客户端就坏了。 有用的思维模型是:你的 API 是一份承诺,规定了调用方可以依赖什么。如果一次变更让一个讲道理的调用方原本依赖的东西失效了,那它就是破坏性的。而调用方依赖的东西,远远多于你的文档明确允许他们依赖的范围。 让所有人都栽跟头的那种变更: 往响应里加一个字段。它只是新增,按理说不可能弄坏一个写得规范的客户端,可它偏偏经常弄坏真实的客户端,因为其中有些客户端会严格校验响应,...

数据库性能:找出拖垮应用的那条查询

数据库性能的排查工作,通常从有人提议换一台更大的实例开始,又通常以这样一个发现结束:每次加载页面时,有一条查询都在对 400 万行做顺序扫描。瓶颈从来不是硬件,瓶颈是执行计划。 这个模式重复得足够稳定,值得当作默认假设写下来。当应用很慢而数据库又很忙时,原因几乎总是少数几条具体的查询,而不是整体容量不足;把机器换大,只能把问题掩盖到表再次长大的那一刻为止。 动手改之前,先量。 凭猜测去优化一条查询,正是团队花掉整整一周添加索引、结果写入变慢而读取一点没快的原因。任何数据库都能告诉你哪些语句消耗的总时间最多。从那里开始,修掉排在最前面的那条,然后再量一次。这样反复两三轮,事故通常就结束了。 数据库性能始于找出那条查询总时间比最坏单次更...

微调 vs RAG vs 提示词:各自的真实成本

微调 vs RAG 这个问题,通常不是以问题的形式出现的,而是以一句结论出现:我们需要用自己的数据微调一个模型。这是企业 AI 里最昂贵的一句话之一,而且多数情况下是错的。不是永远错,但确实是多数。这个诉求背后几乎总是两件事之一:模型不了解我们的业务,或者模型回答的方式不是我们想要的。对第一件事,微调是一个糟糕的解法;对第二件事,微调是一个昂贵的解法。 在微调、RAG 和提示词之间做选择,并不是技术偏好问题。三者各自修复的是完全不同类别的问题,选错了,就会换来几个月的工程投入,而最初那句抱怨依然原封不动地摆在那里。 最省钱的一条规则: 如果问题是模型不知道某件事,用检索。如果问题是模型知道,但回答的风格、格式或长度不对,先改提示词,...

迁移出 OpenAI:换用开放权重模型的真实成本

进入 2026 年后,认真考虑迁移出 OpenAI 的团队明显变多了。开放权重模型在日常生产任务上的质量已经很难与头部模型区分开来,公开单价更低,而权重本身可以下载这一点,把与厂商的关系从依赖变成了选择。 但这并不意味着切换是免费的。API 调用本身几乎一模一样,真正要干活的是它周围的一切。本文讲清楚:哪些东西能原样搬过去,哪些会悄悄出问题,怎样设计一次有意义的比较,以及什么时候留在原地才是正确答案。 先把预期对齐。 换厂商就是换一个基础 URL、一个模型名、一份凭据。但要拿回同样的输出质量,那是以天为单位计的提示词工程。给一个范围明确的功能预留一到三周。任何假设可以即时替换的估算,都是乐观估算。 哪些东西能原样搬过去比你想的多,这...

API 安全:2026 年如何保护一个公开 API

大多数团队把 API 安全当成身份验证问题:发放令牌,在每一条路由上校验它,然后认为事情已经做完了。直到某天,一位测试人员把 URL 里的一个数字改掉,就读到了另一位客户的发票。 「已通过身份验证」和「已获得授权」之间的这道缝隙,正是绝大多数真实 API 泄露事件栖身的地方,而且它并不是扫描器能够稳定发现的那类问题。自动化工具看到一个有效的令牌和一个 200 响应,就报告成功。只有理解你业务规则的人,才会注意到那个响应里装的是别人的数据。 核心区别: 身份验证证明的是谁在调用。授权决定的是这个特定调用方可以看到什么、可以修改什么,而且它必须落实到每一个对象、每一次请求,并在数据层强制执行。几乎所有严重的 API 漏洞,都是第一件事运...

Kimi K3 API:定价、集成与权衡

Kimi K3 API 带着一个不寻常的组合登场:接近前沿水平的基准成绩、激进的定价,以及可供下载的权重。Moonshot AI 于 2026 年 7 月 27 日公开了这些权重,使 K3 成为迄今公开发布的最大模型,也是这一规模的模型首次在原则上可以由你自己运行。 对于已经在向前沿供应商付费的团队来说,这提出的是一个务实问题,而非哲学问题:它在你的技术栈里有没有位置,把一部分流量迁过去究竟会改变什么。本文讨论成本测算、集成工作,以及那些公开数字无法转化为生产表现的环节。 简而言之: Kimi K3 的缓存未命中输入约为每百万 token 3 美元,缓存命中输入约为 0.30 美元,输出约为 15 美元,...

定制 API 开发成本:2026 年你到底为什么付费

凡是按端点数量来估算定制 API 开发成本的人,几乎都会算错,而且通常差三倍。端点本身是整件事里最便宜的部分:十来个端点,只是读写你手里已经有的数据,对一位称职的后端开发者来说不过是两周的活。 真正花钱的,是把这些端点变成另一家公司愿意把生意押上去的东西所需要的一切:经得起安全评审的认证、让你日后还能改主意的版本管理、好到没人需要给你发邮件的文档,以及能告诉你哪个客户今天早上过得不顺的运维装置。有一个 API,和有一个别人依赖着做生意的 API,两者之间的那道落差,才是预算真正的去处。 价格区间速览: 只被你自己的应用调用的内部 API,通常花费 10,000 到 30,000 英镑。由少数几家指定集成方使用的合作伙伴 API,一般...