SOL012_endpoints.yaml 3.23 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
# Copyright (c) ETSI 2019.
# https://forge.etsi.org/etsi-forge-copyright-notice.txt
endpoints:
  api_versions:
    parameters:
      - name: Version
        description: >
          Version of the API requested to use when responding to this request.
        in: header
        required: false
        schema:
          type: string
      - name: Authorization
        description: >-
          The authorization token for the request. Reference: IETF RFC 7235
        in: header
        required: false
        schema:
          type: string
    get:
      summary: Retrieve API version information
      description: >
        The GET method reads API version information. This method shall follow the provisions specified in
        table 4.6.3.3.3.2-1 for request and response data structures, and response codes. URI query parameters are not
        supported.
      responses:
        200:
          description: >
            200 OK
            
            API version information was read successfully.
            The response body shall contain 4.4 API version
            information, as defined in clause 4.4.1.13.
          content:
            application/json:
              schema:
                $ref: '../components/SOL012_schemas.yaml#/components/schemas/ApiVersionInformation'
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
            WWW-Authenticate:
              description: >
                Challenge if the corresponding HTTP request has not provided
                authorization, or error details if the corresponding HTTP
                request has provided an invalid authorization token.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: The used API version.
              schema:
                type: string
                maximum: 1
                minimum: 1
        400:
          $ref: '../components/SOL012_resp.yaml#/components/responses/400'
        401:
          $ref: '../components/SOL012_resp.yaml#/components/responses/401'
        403:
          $ref: '../components/SOL012_resp.yaml#/components/responses/403'
        404:
          $ref: '../components/SOL012_resp.yaml#/components/responses/404'
        405:
          $ref: '../components/SOL012_resp.yaml#/components/responses/405'
        406:
          $ref: '../components/SOL012_resp.yaml#/components/responses/406'
        413:
          $ref: '../components/SOL012_resp.yaml#/components/responses/413'
        414:
          $ref: '../components/SOL012_resp.yaml#/components/responses/414'
        416:
          $ref: '../components/SOL012_resp.yaml#/components/responses/416'
        422:
          $ref: '../components/SOL012_resp.yaml#/components/responses/422'
        429:
          $ref: '../components/SOL012_resp.yaml#/components/responses/429'
        500:
          $ref: '../components/SOL012_resp.yaml#/components/responses/500'
        503:
          $ref: '../components/SOL012_resp.yaml#/components/responses/503'
        504:
          $ref: '../components/SOL012_resp.yaml#/components/responses/504'