(#22356) Add api documentation for reports

The docuementation is now for pson only, but mentiones the deprecated? yaml version.
There is a json-schema, a reference to the documentation for report format 4, and an example.

The schema is validated, and a test validates a generated report against the schema.