Added endpoint that can return single spec files, #PG-4593

[lachiebol]

Description

Can now retrieve all spec files with 'matomo' or a specific plugin with it's name

curl -G 'https://www.example-matomo.com/index.php' \
    --data-urlencode 'module=API' \
    --data-urlencode 'method=OpenApiDocs.getOpenApiSpec' \
    --data-urlencode 'spec={plugin_name}' \
    --data-urlencode 'format=json' \
    --data-urlencode 'token_auth=anonymous'

Issue No

Steps to Replicate the Issue

Checklist

• [✔] Tested locally or on demo2/demo3?
• [✔] New test case added/updated?
• [NA] Are all newly added texts included via translation?
• [NA] Are text sanitized properly? (Eg use of v-text v/s v-html for vue)
• [NA] Version bumped?

[AltamashShaikh]

We should also add a validation for $spec, it should be an valid pluginName

[lachiebol]

@AltamashShaikh I've changed that, also removed the single spec file logic from the endpoint. I don't think it's really required anymore.

[AltamashShaikh]

@lachiebol Should we change the parameter name to pluginName from spec ?

Suggested change

	public function getOpenApiSpec(string $spec, string $format = 'json'): array
	public function getOpenApiSpec(string $plugin, string $format = 'json'): array

[AltamashShaikh]

This comment is optional

[lachiebol]

@AltamashShaikh pluginName sounds more accurate, changed that

[AltamashShaikh]

Left 1 optional comment, looks good to me

[lachiebol]

Tests failed just fixing...