如何优化Podio API调用？实现单请求获取关联应用数据

问题描述 #

我正在清理并优化基于Podio API的代码。目前我通过筛选查询从一个应用获取数据集合，再循环遍历该集合，在每个条目上调用Podio get_field_value来获取关联应用字段的值，这会产生大量API请求。我希望通过单次API请求获取所有数据，类似MySQL中JOIN的实现方式。以下是我当前代码的简化版本：

$collection = PodioItem::filter(WHSE_ID, array( 
    "filters" => array( WHSE_EQUP_STATUS => array(2), ), 
    "sort_by" => WHSE_LOAD_IN, 
    "sort_desc" => false, 
    "limit" => 50 
) );
foreach ($collection as $item) {
    // Table-A ID
    $whId = $item->item_id;
    // Referenced App Item(s)
    $nucId = $item->fields[0]->values[0]->item_id;
    // Get Referenced App Item Field
    $app_b_value = PodioItem::get_field_value($nucId, NUC_LOAD_OUT);
    echo $app_b_value;
}

请问是否存在更高效的实现方式？

解决方案 #

当然有更高效的方式！Podio的filter API本身就支持直接包含关联应用的完整数据，完全不需要循环发起额外请求，这就相当于实现了类似SQL JOIN的效果，能帮你把API调用次数从N+1次降到1次。

具体实现步骤：

1. 在filter的参数中添加include选项，指定你要获取关联数据的那个字段的标识（可以是字段的外部ID或者字段ID）。
2. 直接从返回的集合条目中提取关联字段的对应值，无需再调用PodioItem::get_field_value。

修改后的代码示例：

// 注意添加了"include"参数，指定关联字段的外部ID/字段ID
$collection = PodioItem::filter(WHSE_ID, array(
    "filters" => array( WHSE_EQUP_STATUS => array(2) ),
    "sort_by" => WHSE_LOAD_IN,
    "sort_desc" => false,
    "limit" => 50,
    "include" => array(WHSE_EQUP_NUC) // 替换为你主应用中关联到App B的字段标识
) );

foreach ($collection as $item) {
    $whId = $item->item_id;
    
    // 直接从关联字段中获取完整的关联条目数据
    $nucItem = $item->fields[WHSE_EQUP_NUC]->values[0]; // 单关联场景
    
    // 直接提取关联条目中的目标字段值
    $app_b_value = $nucItem->fields[NUC_LOAD_OUT]->values;
    echo $app_b_value;
}

额外说明：

• 如果你的关联字段是多关联（一个主条目关联多个App B的条目），只需要循环$item->fields[WHSE_EQUP_NUC]->values数组即可，每个元素都是一个完整的关联条目对象。
• 这种方式不仅能大幅提升性能，还能避免触发Podio的API速率限制，同时让代码结构更简洁易维护。

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