Invalid examples & schemas for XML and JSON generated in API docs

[wanderzell]

We are struggling figuring out proper way how to fully support multiple media types (json, json-ld, xml) while having proper documentation and schemas in the API documentation.

At the beginning, it seemed the issue is specific to our software or set up. Then we looked at official demo or API Platform and saw all the same errors.

For example in https://demo.api-platform.com/docs

Books resource

Seems like the plain JSON example and schema does not exist and JSON LD version is used instead. However, that's not correct since plain JSON response only returns subset of fields of what's shown in the example:

Reviews resource

Looks like XML example is generated from JSON LD and thus contains invalid tags.

Please advise what would be appropriate workaround, or how was this intended to work originally?

[Chris53897]

It worked in API-Platform 2.6.0 until 2.6.2 or 2.6.3. So i hope this is just a bug in 2.6.4.

[soyuka]

We don't have much tests for XML but I'd like to fix this. I don't think that our Schema generation supports XML moving this to /core

[tecbird]

May Duplicate of #4212 / #4215

[alanpoulain]

Probably solved by 2.6.5.