```html

调一个第三方支付接口，接i接文档里写着“引入SDK，口和口配置密钥后调用API即可完成支付”。区别很多人看到这句话就懵了——SDK和API到底是接i接不是一回事？如果是两个东西，为什么总被绑在一起说？口和口

我刚开始做后端那会儿，也在这个问题上卡过。区别当时接微信支付，接i接同事扔过来一个jar包说“用这个SDK”，口和口我打开一看，区别里面全是接i接封装好的类和方法。但当我翻到微信支付的口和口官方文档，满屏都是区别“APIv3密钥”“API证书”“请求签名”。那一刻我才意识到，接i接SDK和API虽然经常一起出现，口和口但根本不在一个层面上。区别

API是契约，SDK是工具包

API全称Application Programming Interface，翻译过来叫应用程序编程接口。说人话就是：两个软件之间约定好的对话方式。它本质上是一份契约——你按我的格式发请求，我就按约定的格式回你数据。这份契约可以写在文档里，可以用HTTP协议实现，也可以用WebSocket，甚至可以是本地进程间通信。

举个例子。你打开天气App，它要显示“北京今天晴，25℃”。这个数据哪来的？天气App的服务器去调用气象服务商的API，发一个HTTP请求过去，对方返回一段JSON。这个过程中，API就是那个“请求格式+返回格式”的约定。至于你用什么语言发请求、用什么库解析JSON，API不关心。

SDK全称Software Development Kit，软件开发工具包。它是一堆代码、库、文档和示例的集合，目的是让你更省事地调用某个API。微信支付的SDK里封装了签名生成、证书加载、请求发送、响应验签这些脏活累活。没有SDK，你得自己读文档、拼参数、处理加密。有了SDK，可能就三行代码。

一个具体场景：地图服务

假设你要在App里加一个“显示附近加油站”的功能。高德地图提供API，你发一个HTTP GET请求，带上经纬度和半径，它返回加油站列表的JSON。这个API是语言无关的，你用Java、Python、Go都能调。

但高德也提供Android SDK和iOS SDK。Android SDK里有一个AMapLocationClient类，你初始化它、设置监听器、调用startLocation()，定位结果就回调给你了。底层它帮你处理了权限申请、GPS/基站/WiFi混合定位、坐标系转换。如果没有这个SDK，你得自己写JNI调用高德的C库，或者自己封装HTTP请求并处理各种边界情况。

所以你看，API是“能做什么”，SDK是“怎么更方便地做”。API是菜单，SDK是帮你把菜切好、调料配好的料理包。你可以不用料理包，自己买原料按菜单做，但大多数人会选择料理包，因为快且不容易出错。

为什么有人会混淆

因为很多SDK的名字里带API。比如“微信支付APIv3 SDK”“AWS SDK for Java”。这种命名让初学者以为SDK就是API的另一种叫法。实际上，SDK是API的客户端实现。一个API可以有多个SDK——官方Java版、官方Python版、社区维护的Go版。它们调用的都是同一个API，只是封装方式不同。

另一个混淆点是：有些服务只提供SDK，不直接暴露API。比如某些游戏引擎的插件，你只能通过它提供的SDK来集成，没法直接发HTTP请求。这种情况下，SDK成了唯一入口，但它内部依然在调用某个API——只是那个API不对外开放。

选哪个？看场景

如果你只是临时调一次接口，或者用一个小众语言，直接调API更灵活。用curl、Postman或者几行HTTP客户端代码就能搞定，不用引入一堆依赖。

如果你要集成到生产项目里，尤其是涉及加密、重试、连接池、日志这些通用逻辑，SDK能省你很多时间。但要注意SDK的版本更新——API变了，SDK没跟上，你就卡住了。我遇到过某个云存储SDK半年没更新，新出的分片上传API它不支持，最后只能自己手写HTTP请求。

还有一点：SDK会隐藏细节，这对新手是好事，对老手可能是坏事。出问题时，如果你不理解底层API的签名机制，光看SDK的报错“签名错误”会一头雾水。这时候就得翻回API文档，看看到底是时间戳不对还是参数排序错了。

说到底，API是本质，SDK是包装。理解API让你知道系统之间怎么对话，理解SDK让你知道怎么少写代码。两个都懂，才算真正入门了接口集成这件事。

```