获取用户信息

在本课程中，我们将探讨 users 命名空间的一些重要端点。这些端点需要启用 account_info.read 权限。在本课程中，我们将与以下端点进行交互：

• get_current_account
• get_space_usage

注意：我们在上一课生成访问令牌后，已授予 account_info.read 权限。

获取当前账户信息

users 命名空间提供了以下端点：
/users/get_current_account。
该端点用于通过访问令牌获取用户信息。它使用 Bearer 认证方式，并在 HTTP 请求的头部进行定义。该接口采用 HTTP POST 请求，不接受任何参数。

下面通过代码示例展示该端点的功能。

1import requests
2import json
3
4url = "https://api.dropboxapi.com/2/users/get_current_account"
5
6headers = {
7    "Authorization": "Bearer {{TOKEN}}",
8    "Content-Type": "application/json"
9}
10
11data = None
12r = requests.request("POST", url, headers=headers, data=json.dumps(data))
13print(json.dumps(r.json(), indent=4))

上述代码中包含以下内容：

• 第1–2行：导入运行代码所需的 requests 和 json 库。
• 第4行：这是需要调用的 URL。
• 第6–9行：定义 HTTP 请求的 headers。其中包含认证信息以及内容类型，通常为 application/json。
• 第11行：请求的数据部分，对于此 API 调用设为 None。
• 第12行：创建 POST 请求。
• 第13行：打印返回结果。

响应字段

响应中一些重要字段如下表所示。

获取存储空间使用情况详情

端点 /users/get_space_usage 不接收任何参数，用于返回用户被分配和已使用的存储空间状态。

下面通过代码示例进一步了解用户的空间使用情况。

1import requests
2import json
3
4url = "https://api.dropboxapi.com/2/users/get_space_usage"
5
6headers = {
7    "Authorization": "Bearer {{TOKEN}}",
8    "Content-Type": "application/json"
9}
10
11data = None
12r = requests.request("POST", url, headers=headers, data=json.dumps(data))
13print(json.dumps(r.json(), indent=4))

上述代码中包含以下内容：

• 第4行：请求所使用的 URL。
• 第6–9行：定义 headers 对象。
• 第11行：定义 data 对象，由于本次请求不发送数据，因此设为 None。
• 第12行：使用 url、headers 和 data 创建 POST 请求。
• 第13行：打印格式化的 JSON 响应。

响应字段

以下是空间使用查询返回的各个字段说明。