API接口调用方法详解

什么是API 接口

在开发天气小程序、查询快递状态或者接入支付功能时，你可能已经用过API接口。简单说，API就是程序之间沟通的“桥梁”。比如你在手机App上点外卖，App会通过API向服务器要数据，比如商家列表、菜品信息，然后展示给你。

常见的API调用方式

目前大多数网络服务都采用HTTP协议进行API通信，最常见的是RESTful风格。这类接口通常通过URL地址加参数的方式获取数据，返回格式多为JSON。

举个例子，你想获取某个城市的实时天气，可能会调用这样的地址：

https://api.weather.com/v1/weather?city=beijing&apikey=your_key_here

这里，https://api.weather.com/v1/weather 是接口地址，city 和 apikey 是传递的参数。其中 apikey 是你的身份凭证，就像进门的钥匙，少了它请求会被拒绝。

使用GET方法调用API

GET是最基础的请求方式，适合获取数据。可以直接在浏览器地址栏输入带参数的URL测试。也可以用JavaScript中的fetch函数：

fetch('https://api.example.com/data?user=id123')
  .then(response => response.json())
  .then(data => console.log(data));

这段代码会向指定接口发起请求，并把返回的数据打印出来。如果接口正常，你会看到结构清晰的JSON内容。

POST请求怎么写

当你需要提交数据，比如用户登录、上传订单时，就得用POST方法。它把数据放在请求体里，比GET更安全，也支持更复杂的内容。

还是用fetch演示：

fetch('https://api.example.com/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    username: 'zhangsan',
    password: '123456'
  })
})
.then(res => res.json())
.then(data => console.log(data));

注意这里的 headers 设置了内容类型，body 把对象转成了字符串。服务器收到后会验证账号密码，返回登录结果。

处理跨域和认证问题

前端直接调用第三方API时，常遇到“跨域”错误。这是因为浏览器的安全策略限制。解决办法通常是让后端做代理转发，或者确认对方API是否支持CORS（跨域资源共享）。

另外，很多API需要认证。除了API Key，还有OAuth、Token等方式。比如微博或微信登录，就是跳转到平台授权，拿到临时令牌后再换取用户信息。

调试API的小技巧

刚接触API时容易出错。推荐用Postman这类工具手动测试，填好地址、参数、请求头，点一下就能看结果。比写代码试错快得多。

看到返回的错误码也别慌。比如401表示未认证，检查密钥对不对；404是地址错了；500一般是服务器那边出了问题。对照文档逐项排查，基本都能解决。

实际应用场景举例

小李做了一个个人博客，想在首页显示最近的GitHub提交记录。他找到了GitHub的API文档，用下面这行代码就拿到了数据：

fetch('https://api.github.com/users/lilei/repos')
  .then(r => r.json())
  .then(repos => console.log(repos));

接着筛选出主分支最新的提交时间，格式化后展示在页面上。整个过程没碰服务器，纯前端实现，省事又高效。

API接口调用并不神秘，关键是理解请求的组成要素：地址、方法、参数、认证。动手试几次，慢慢就熟悉了。现在各种开放平台都有详细文档，照着示例改一改，基本都能跑通。

API接口调用方法详解：从入门到实战