接受 API 中的标头

当我们使用 API 时，经常需要在请求中传递一些数据或信息。除了在请求主体中传递外，还可以在请求头中添加信息，例如在请求中携带 Token 或者设置内容类型等。

在编写代码时，我们也需要接受 API 返回的标头信息。几乎所有的 API 都会返回一些标头，例如响应状态码、内容类型、缓存控制等。在接收这些标头时，我们可以更加精确地理解返回的数据，以及根据标头信息进行合理的处理。

以下是一些常见的标头信息，以及如何在不同编程语言中接受：

响应状态码

响应状态码表示服务器对请求的响应结果，状态码有各自的含义。例如，200 表示请求成功，404 表示请求的资源不存在，500 表示服务器错误等等。

在 JavaScript 中，通过 XMLHttpRequest 对象的 status 属性即可获取响应状态码：

var xhr = new XMLHttpRequest();
xhr.open('GET', '/api/data', true);
xhr.onreadystatechange = function() {
  if (xhr.readyState === 4) {
    if (xhr.status === 200) {
      console.log(xhr.responseText);
    } else {
      console.error('请求失败：', xhr.status);
    }
  }
};
xhr.send();

在 Python 中，通过 requests 库的 Response 对象的 status_code 属性即可获取响应状态码：

import requests

response = requests.get('/api/data')
if response.status_code == 200:
    print(response.text)
else:
    print('请求失败：', response.status_code)

内容类型

内容类型表示返回信息的格式，例如 text/html 表示返回 HTML 格式数据，application/json 表示返回 JSON 格式数据等等。

在 JavaScript 中，通过 XMLHttpRequest 对象的 getResponseHeader 和 getAllResponseHeaders 方法可以获取单个或者所有的响应标头：

var xhr = new XMLHttpRequest();
xhr.open('GET', '/api/data', true);
xhr.onreadystatechange = function() {
  if (xhr.readyState === 4) {
    var contentType = xhr.getResponseHeader('Content-Type');
    console.log('响应类型：', contentType);
    console.log('所有标头：', xhr.getAllResponseHeaders());
  }
};
xhr.send();

在 Python 中，通过 requests 库的 Response 对象的 headers 属性可以获取所有的响应标头：

import requests

response = requests.get('/api/data')
print('响应类型：', response.headers['Content-Type'])
print('所有标头：', response.headers)

缓存控制

缓存控制表示请求或者响应是否需要缓存，以及缓存的有效时间等。例如，Cache-Control 标头可以指定缓存有效期，Pragma 标头可以指定不使用缓存等等。

在 JavaScript 中，通过 XMLHttpRequest 对象的 setRequestHeader 方法可以设置请求标头：

var xhr = new XMLHttpRequest();
xhr.open('GET', '/api/data', true);
xhr.setRequestHeader('Cache-Control', 'no-cache');
xhr.onreadystatechange = function() {
  if (xhr.readyState === 4) {
    console.log(xhr.responseText);
  }
};
xhr.send();

在 Python 中，通过 requests 库的 get 方法的 headers 参数可以设置请求标头：

import requests

response = requests.get('/api/data', headers={'Cache-Control': 'no-cache'})
print(response.text)

以上是一些常见的 API 标头信息以及如何接受的介绍，希望可以对广大开发者有所帮助。