Our API has the requirement to allow searching for "things" using specific identifiers, which may exceed the max length of the GET query string. Our current implementation uses HTTP POST and sends a JSON data structure with the varying criteria.

From my research so far, I am getting the impression I will need to create a custom HttpOperation to achieve my goal. I wanted to extend the GetCollection and change its method to POST, but that class is final and cannot be extended.

Before I dive too deeply into this rabbit hole, I was looking to get feedback from the community in case this has already been solved, or what the best direction would be to solve this problem myself.

Info:

• Symfony 8.1 application
• API Platform (api-platform/symfony): 4.3.17
• Using application/json or application/ld+json (json preferred)

Examples:
curl -X POST https://api.local/users --json '{"username": ["bobby", "jb1234", "billyjoearmstrong", ...]}'
curl -X POST https://api.local/users --json '{"uniqueId": [123, 456, 789, ...]}'
curl -X POST https://api.local/users --json '{"somethingElse": ["other", "unique", "criteria", ...]}'

Requirements:

1. Stays within the best practices of API Platform (i.e., not using Symfony controllers)
2. Works like the GetCollection and can be re-used across multiple resources
3. Accept a specific data structure shape and can be easily validated
4. Still allow URI variables for filtering and paginating the dataset

Thank you in advance!