获取数据
请求结构解析
为了了解数据端点的工作原理,让我们分解一个示例 API 请求的结构。本例中,我们查看 2023 年西班牙的出口产品:
1. 根 URL
这是 API 的根 URL,所有请求都以此为基础。它将返回一个包含记录列表的 JSON 对象。如果您更喜欢其他格式,可将扩展名更改为
.csv
、.xlsx
或 .parquet
。2. 立方体(数据集)
这是您要查询的数据集。您可以通过查询 立方体端点 来获取所有可用数据集的列表。
3. Drilldowns
这是您要在查询中添加的 drilldowns(下钻维度)。Drilldowns 表示您希望在响应中查看的列(或维度)。您可以通过查询 trade_i_baci_a_22 立方体端点 来获取该立方体可用的所有 drilldowns 列表。
4. 度量
这是您要在查询中添加的度量。度量表示您希望在响应中查看的列(或指标)。您可以通过查询 trade_i_baci_a_22 立方体端点 来获取该立方体所有可用度量的列表。请注意,度量会根据立方体的默认聚合函数自动汇总。
5. Include(或过滤)
这是您要在查询中添加的过滤条件。指定立方体可用的任意列(或维度)均可用于过滤响应。可用分号分隔多个过滤条件。过滤语法由列名和要过滤的值两部分组成。如需查找特定列的可用值,可查询该立方体的成员端点并指定 level 参数。例如,要查找“Exporter Country”列的可用值,可查询 'Exporter Country' 成员端点。
6. Limit 与 Offset
这是您要在查询中添加的记录限制,其中第一个数字为返回记录数的上限,第二个数字为偏移量。
7. Token
这是您要在查询中添加的令牌,用于验证您的请求。您可登录后点击页面右上角的 账户 链接来获取令牌。