如何通过Podio API筛选获取指定列数据？

Podio 的 /item/app/{app_id}/filter/ 接口支持通过指定字段列表返回仅你需要的数据，以下是具体实现方式：

核心要点 #

你需要使用字段的外部ID（而非显示列名）来指定要获取的列，外部ID可在Podio应用的字段设置页面中找到。

POST 请求（推荐） #

POST 请求适合带复杂筛选条件的场景，参数放在请求体中：

• 请求URL：替换 {app_id} 为你的应用ID，示例：https://api.podio.com/item/app/12345/filter/
• 请求头：
  • Authorization: OAuth2 {你的访问令牌}
  • Content-Type: application/json
• 请求体示例（仅获取指定列）：

  {
    "fields": ["order-id", "city", "country"]
  }
  

• 带筛选条件的请求体示例（比如筛选已完成的订单）：

  {
    "filters": {
      "order-status": {"values": ["completed"]}
    },
    "fields": ["order-id", "city", "country"],
    "limit": 50,
    "offset": 0
  }
  

GET 请求（仅适合简单场景） #

如果没有复杂筛选条件，也可以用GET请求，将字段列表放在查询参数中：

https://api.podio.com/item/app/12345/filter/?fields=order-id,city,country

注意：GET请求的查询字符串长度有限制，复杂筛选场景优先用POST。

注意事项 #

• 必须使用字段的外部ID，否则API无法识别并返回对应数据。
• 确保访问令牌有对应应用的读取权限，否则会返回权限错误。
• 可通过 limit 和 offset 参数实现分页，默认返回20条数据。

内容的提问来源于stack exchange，提问作者praphull raj