如何在PHP的Podio API中按电子邮件字段过滤项目？

Question

I need to get an item from a collection of items that contains the email address <my-email>

Here is the structure of that part of the object:

[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>
                                                    )

                                            )

This is the code I have tried:

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

but i keep getting the error:

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

What am I missing here?

I would prefer to find this item using the external_id rather than the 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'
        ]
    ]
]);

In the "Developer" section of your app you can find the field ID for your field with email type.

If you will call filter by multiple emails, then Podio will return the result, if one of them will be found.