Skip to content

Swaggers make the 'Version' field as 'required'; However the SOL spec (SOL013) marks 'Version' as optional.

List of swagger / yaml files, along with the line numbers:

./src/SOL005/components/SOL005_params.yaml-1-components: ./src/SOL005/components/SOL005_params.yaml-2- parameters: ./src/SOL005/components/SOL005_params.yaml-3- Version: ./src/SOL005/components/SOL005_params.yaml-4- name: Version ./src/SOL005/components/SOL005_params.yaml-5- description: > ./src/SOL005/components/SOL005_params.yaml:6: Version of the API requested to use when responding to this request. ./src/SOL005/components/SOL005_params.yaml-7- in: header ./src/SOL005/components/SOL005_params.yaml-8- required: true ./src/SOL005/components/SOL005_params.yaml-9- schema: ./src/SOL005/components/SOL005_params.yaml-10- type: string ./src/SOL005/components/SOL005_params.yaml-11-

./src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml-661-# - name: Version ./src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml-662-# description: | ./src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml:663:# Version of the API requested to use when responding to this request. ./src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml-664-# in: header ./src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml-665-# required: true ./src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml-666-# type: string

./src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml-441-# type: string ./src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml-442-# - name: Version ./src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml-443-# description: | ./src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml:444:# Version of the API requested to use when responding to this request. ./src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml-445-# in: header ./src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml-446-# required: true ./src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml-447-# type: string

That's causing issues with the generated Java code, as the API makes the 'Version' mandatory, and non-compilant with the SOl013 Spec.

--- From Sol013 --- "The API producer shall support receiving and interpreting the "Version" HTTP header. The API producer shall include in the response the "Version" HTTP header signaling the used API version, including the "impl" version parameter if available. If the "impl" version parameter has been omitted in the request, the API producer shall use the combination of MAJOR, MINOR and PATCH as requested and the highest supported value for the "impl_version" field of the "impl" version parameter for that combination, if available."

To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information