Core: [Question] Add exsisting route to Api-platform

[fedotovaleksandr]

Hi guys! I have existing route
(
for example api_ping that return only 200 status
@Route("/ping", name="api_ping")
) .

How i can add this route to api-platform's docs ?

[meyerbaptiste]

You can follow these links:

• https://github.com/api-platform/docs/issues/143#issuecomment-260221717
• https://github.com/api-platform/core/issues/887
• https://github.com/api-platform/api-platform/issues/185
• https://github.com/api-platform/core/pull/886

[fedotovaleksandr]

@meyerbaptiste thanks! But in all Issues, work with Entity and _api_resource_class , can i add route to docs without resourse_class?

[meyerbaptiste]

I use my joker: ping @Simperfit aka Swagger killer

[soyuka]

@fedotovaleksandr I don't see anything in the code the would prevent you from adding a custom operation to the docs. But, I think that any Operation needs to be associated to an @ApiResource to be detected as one ('_api_resource_class').

[meyerbaptiste]

Or you can decorate the api_platform.swagger.normalizer.documentation service.

[backbone87]

maybe an @ApiOperation would be something useful? this would allow to work operation centric

[fedotovaleksandr]

@backbone87 Hi my friend,thanks for reply! I can't find this annotation in ApiPlatformCoreAnnotation*
it's swagger annotation?

[soyuka]

There are no such annotation yet @fedotovaleksandr

[fedotovaleksandr]

@soyuka Thanks .

[raziel057]

I'm also very interested by this kind of annotation, which could be used to document routes that are not directly related to an entity. Sometimes you need a ping route or aggregation and it would be great to see it in Swagger view.