我如何在跑道 API for PHP 中通过电子邮件字段过滤项目？

Question

我需要从包含电子邮件地址 <my-email>

的项目集合中获取一个项目

这是对象那部分的结构：

[2] => PodioEmailItemField Object
                            (
                                [__attributes:PodioObject:private] => Array
                                    (
                                        [field_id] => <my-field-id>
                                        [type] => email
                                        [external_id] => email
                                        [label] => Email
                                        [values] => Array
                                            (
                                                [0] => Array
                                                    (
                                                        [type] => work
                                                        [value] => <my-email>
                                                    )

                                            )

这是我试过的代码：

$items = PodioItem::filter($app_id, array('filters'=>
                                    array(
                                          'email'=>
                                           array(
                                                'values'=>
                                                 array(
                                                       array(
                                                             'value'=>'<my-email>'))))));

但我一直收到错误消息：

Fatal error: Uncaught PodioBadRequestError: "Invalid value {"values": [{"value": "<my-email>"}]} (object): must be array" 

我在这里错过了什么？

我更愿意使用 external_id 而不是 field_id

查找此项目

Answer 1

$items = \PodioItem::filter($app_id, [
    'filters' => [
        // replace 123456 with field ID for your field with email type
        '123456' => [
            'test1@example.com', 
            // 'test2@example.com',
            // 'test3@example.com'
        ]
    ]
]);

在您应用的 "Developer" 部分，您可以找到您的字段的字段 ID 和电子邮件类型。

如果您将通过多个电子邮件调用过滤器，那么跑道将return结果，如果找到其中一个。