Skip to content

OpenAPI spec references non-existent schema NamespaceJson #1413

@andrew

Description

@andrew

The OpenAPI specification at https://open-vsx.org/v3/api-docs/registry contains an invalid schema reference.

I believe this bug is fixed in this repo rather than https://github.com/EclipseFdn/open-vsx.org as this contains the code that generates the schema file, but I can re-report it over there if you'd prefer?

Details

Location: /api/user/namespace/create POST endpoint requestBody

Issue: References #/components/schemas/NamespaceJson which does not exist in the components/schemas section.

Available schemas: Namespace and NamespaceDetails

Steps to reproduce:

  1. Download the spec:
curl -o openvsx.json https://open-vsx.org/v3/api-docs/registry
  1. Validate with swagger-cli:
npx @apidevtools/swagger-cli validate openvsx.json
  1. Result: Token "NamespaceJson" does not exist.
  2. Validate with Redocly CLI:
npx @redocly/cli lint openvsx.json
  1. Result:
Can't resolve $ref at #/paths/~1api~1user~1namespace~1create/post/requestBody/content/application~1json/schema

Expected: The reference should likely point to #/components/schemas/Namespace instead.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions