Skip to main content

HTTP 标头

本节介绍 API 将从任何请求中接受的 HTTP 标头。

内容类型​

所有请求都必须包含一个内容类型 HTTP 标头。

接受的内容类型​

基本格式内容类型内容类型
JSON应用程序/jsontext/json 目前不是可接受的内容类型
表格数据multipart/form-data仅在上传变体时使用

内容类型错误​

响应代码说明
400内容类型可以理解，但无法解码。更多信息将显示在响应正文中
415内容类型缺失或不支持

注意：如果内容类型标头有问题，那么响应内容类型将是 API 的默认格式，目前为 application/json

注意：如果请求的内容类型有效，所有响应都将以与接收请求相同的内容类型发送。

授权​

此标头为可选标头，用于向 API 提供当前用户的身份验证详细信息，使当前用户能够访问受限的 API 资源。可通过登录 API 获取令牌。标题示例如下


Authorization: Bearer 45267dbe480c8c7d799c62ccad92cb44f67ab086

授权头接受一个由两部分组成的字符串，两部分之间用一个空格隔开。第一部分是令牌类型，第二部分是访问令牌本身。

授权错误​

响应代码说明
400提供了畸形的授权标头
401授权标头丢失或令牌无效或过期

选择授权令牌类型​

如果失败，响应标头将包含一个 WWW-Authenticate 标头，该标头将显示访问所需的令牌类型。