No item route associated when itemOperations is set but empty

[symfonyaml]

API Platform version(s) affected: 2.5.4

Description

When the itemOperations is empty, and collectionOperations is set, there is an error when fetching the collection like [GET] /api/books

No item route associated with the type "App\Entity\Book"
error in RouteNameResolver.php line 62

How to reproduce

Create an entity with the api mapping

App\Entity\Book:
    itemOperations: {} # <---- this creates the bug
    collectionOperations: { get: ~ }

Possible Solution

in RouteNameResolver.php line 50, the value returned in the sprintf for $operationType should be collection, but its item instead.

Then the route default value _api_item_operation_name does not exists so no route is not found.
When I replace by _api_collection_operation_name it works.

Occurences

• In this comment
• Looks like this ticket is a duplicate. It uses itemOperations: [] too

[soyuka]

Indeed the safe way to diable item operations is to do:

/**
 * @ApiResource(
 *     itemOperations={
 *         "get"={
 *             "method"="GET",
 *             "controller"=NotFoundAction::class,
 *             "read"=false,
 *             "output"=false,
 *         },
 *     },
 * )
 */

As documented at the end of this section.

[symfonyaml]

@soyuka thanks for your answer.
Unfortunately your solution still list the get item endpoint in the swagger doc.
I am really confused why it would not be possible to just have a list endpoint for an entity.

[versh23]

you can remove it by swagger decorator https://api-platform.com/docs/core/swagger/#overriding-the-openapi-specification

[akerouanton]

You can also manually set the IRI used by the normalization context, such that it won't try to generate one:

App\Entity\Book:
    itemOperations: {}
    collectionOperations: { get: { normalization_context: { iri: "" } } }