SOL009_endpoints.yaml 4.4 KB
Newer Older
# 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
Giacomo Bernini's avatar
Giacomo Bernini committed
        schema:
          type: string
      - name: Authorization
        description: >-
          The authorization token for the request. Reference: IETF RFC 7235
        in: header
        required: false
        schema:
          type: string
    get:
      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.
Giacomo Bernini's avatar
Giacomo Bernini committed
          content:
            application/json:
              schema:
                $ref: '../components/SOL009_schemas.yaml#/components/schemas/ApiVersionInformation'
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
Giacomo Bernini's avatar
Giacomo Bernini committed
              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.
Giacomo Bernini's avatar
Giacomo Bernini committed
              schema:
                type: string
                maximum: 1
                minimum: 1
        400:
          $ref: '../components/SOL009_resp.yaml#/components/responses/400'
Giacomo Bernini's avatar
Giacomo Bernini committed
        401:
          $ref: '../components/SOL009_resp.yaml#/components/responses/401'
Giacomo Bernini's avatar
Giacomo Bernini committed
        403:
          $ref: '../components/SOL009_resp.yaml#/components/responses/403'
Giacomo Bernini's avatar
Giacomo Bernini committed
        404:
          $ref: '../components/SOL009_resp.yaml#/components/responses/404'
Giacomo Bernini's avatar
Giacomo Bernini committed
        406:
          $ref: '../components/SOL009_resp.yaml#/components/responses/406'
Giacomo Bernini's avatar
Giacomo Bernini committed
        413:
          $ref: '../components/SOL009_resp.yaml#/components/responses/413'
Giacomo Bernini's avatar
Giacomo Bernini committed
        414:
          $ref: '../components/SOL009_resp.yaml#/components/responses/414'
Giacomo Bernini's avatar
Giacomo Bernini committed
        416:
          $ref: '../components/SOL009_resp.yaml#/components/responses/416'
Giacomo Bernini's avatar
Giacomo Bernini committed
        422:
          $ref: '../components/SOL009_resp.yaml#/components/responses/422'
Giacomo Bernini's avatar
Giacomo Bernini committed
        429:
          $ref: '../components/SOL009_resp.yaml#/components/responses/429'
Giacomo Bernini's avatar
Giacomo Bernini committed
        500:
          $ref: '../components/SOL009_resp.yaml#/components/responses/500'
Giacomo Bernini's avatar
Giacomo Bernini committed
        503:
          $ref: '../components/SOL009_resp.yaml#/components/responses/503'
Giacomo Bernini's avatar
Giacomo Bernini committed
        504:
          $ref: '../components/SOL009_resp.yaml#/components/responses/504'
    post:
      description: >
        This method is not supported. When this method is requested on this resource, the API producer shall return a "405
        Method Not Allowed" response as defined in SOL013 clause 6.4.
      responses:
        405:
          $ref: ../responses/SOL002SOL003_resp.yaml#/components/responses/405
    put:
      description: >
        This method is not supported. When this method is requested on this resource, the API producer shall return a "405
        Method Not Allowed" response as defined in SOL013 clause 6.4.
      responses:
        405:
          $ref: ../responses/SOL002SOL003_resp.yaml#/components/responses/405
    patch:
      description: >
        This method is not supported. When this method is requested on this resource, the API producer shall return a "405
        Method Not Allowed" response as defined in SOL013 clause 6.4.
      responses:
        405:
          $ref: ../responses/SOL002SOL003_resp.yaml#/components/responses/405
    delete:
      description: >
        This method is not supported. When this method is requested on this resource, the API producer shall return a "405
        Method Not Allowed" response as defined in SOL013 clause 6.4.
      responses:
        405:
          $ref: ../responses/SOL002SOL003_resp.yaml#/components/responses/405