sdk和api的区别

SDK和API的区别

你调用过微信支付。扫码、区别确认、区别扣款，区别一气呵成。区别这背后是区别微信支付团队给你的一套东西——可能是一个 .jar 包，也可能是区别一段 import 就能用的代码。你管它叫“接口”。区别但严格说，区别你用的区别其实是 SDK。API 藏在 SDK 里面，区别像引擎藏在引擎盖下面。区别

API 是区别“门”。推开这扇门，区别你能拿到数据，区别或者触发一个动作。比如高德地图的天气查询 API：你发一个 HTTP 请求，带上城市编码，它返回 JSON。就这么简单。API 不关心你用什么语言，不关心你跑在服务器还是浏览器。它是协议，是约定。你调 GET /weather?city=110000，它给你结果。没了。

SDK 是“工具箱”。工具箱里不只有那扇门，还有螺丝刀、扳手、说明书。微信支付 SDK 除了封装 API 调用，还帮你处理签名、证书、重试、日志。你写三行代码，它背后跑了几百行。没有 SDK，你得自己拼 HTTP 请求、算 HMAC-SHA256、解析 XML 响应。能做，但累。SDK 把脏活累活包了。

我见过一个团队，直接拿 API 文档手搓调用。两周后上线，第三天出问题——签名算法漏了 URL 编码。日志里全是 401。换成官方 SDK，半天改完。这不是 SDK 比 API 高级，是 SDK 替你踩了坑。

反过来，有些场景用 SDK 反而笨重。比如你只是偶尔查一次天气，没必要引入一个 20MB 的 Java SDK。一个 curl 命令调 API 就够了。SDK 带来便利，也带来依赖。版本冲突、包体积膨胀、语言绑定——这些都是代价。API 没这些问题，它只是一串约定。

从实现角度看，API 通常指 HTTP 接口、RPC 接口，或者库函数签名。SDK 是一组工具、库、文档、示例代码的集合。一个 SDK 可能封装多个 API。比如 AWS SDK for Python（boto3）封装了 S3、EC2、Lambda 上百个 API。你调 boto3.client('s3').list_buckets()，背后是 HTTP 请求加签名加重试。API 是那个 HTTP 请求，SDK 是那个 Python 方法。

有人把 API 比作菜单，SDK 比作整套厨房设备。菜单告诉你有什么菜、怎么点。厨房设备让你自己炒。这个比喻不完美——SDK 也提供“点菜”功能，只是顺便把锅碗瓢盆都给你了。更准确说：API 是接口规范，SDK 是接口规范的实现加辅助工具。

实际工作中，你很少二选一。用 SDK 的时候，你也在用 API——只是不直接碰。用 API 的时候，你可能自己写了个小 SDK。界限模糊。但概念要分清：API 是契约，SDK 是产品。契约可以独立存在，产品必须实现契约。

最后说个细节。很多文档写“调用 API”，其实让你下载 SDK。这是行业习惯，不严谨但常见。你心里明白就行：API 是那扇门，SDK 是门加门框加门把手加安装说明书。你要进门，推门就行。但门怎么造、门框怎么装，那是另一回事。