openapi: 3.1.0
info:
  title: Space-Market API v4
  version: 1.0.0
  summary: An API ment for communication in a simple market system.
  description: |
    This defines how the Space-Market defines its well-known endpoint.

    For the actual API see: v4/space-market.yaml
  license:
    name: MIT License
    identifier: MIT
    url: https://spdx.org/licenses/MIT.html
servers:
  - url: http://example.space-market.server
security: []
paths:
  /_market/versions:
    get:
      summary: Returns the versions supported by the server
      description: Returns the versions, which are supported. This is usually defined by the server, but a reverse proxy might override it to point to other endpoints.
      responses:
        '200':
          description: Returns versions, the server may support. The endpoints should be resolved like '/api/{version}/'.
          content:
            application/json:
              schema:
                type: object
                properties:
                  versions:
                    description: This array should be sorted by how good the server can handle the API.
                    type: array
                    items:
                      type: string
                      enum:
                        - v4
                        - v3
                        - v1
        '404':
          description: |
            The APIs are not publicly visible or the server does not implerment the endpoint.

            Frontends should throw a error or request the user to enter the complete endpoint.
components: {}
