Commit cb4bb141 authored by Miguel Angel Reina Ortega's avatar Miguel Angel Reina Ortega
Browse files

Adding config file for OpenAPI generation

parent c0137ed6
Loading
Loading
Loading
Loading
+83 −0
Original line number Original line Diff line number Diff line
data_model_headings:
  headings1:
    - '6[ ]*Data model$'
    - '7[ ]*API definition$'

api_def_headings:
  headings1:
    - '7[ ]*API definition$'
    - '8[ ]*History$'
    
servers:
  - url: https://localhost/ss/v2
    
tags:
- 'sensor-sharing'

fake_data_types: false

manual_types:
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          format: uri
          description: A URI reference according to IETF RFC 3986 that identifies the problem type
        title:
          type: string
          description: A short, human-readable summary of the problem type
        status:
          type: integer
          format: uint32
          description: The HTTP status code for this occurrence of the problem
        detail:
          type: string
          description: A human-readable explanation specific to this occurrence of the problem
        instance:
          type: string
          format: uri
          description: A URI reference that identifies the specific occurrence of the problem


info:
  contact:
    url: https://forge.etsi.org/rep/mec/gs046-ss-api
  title: 'ETSI GS MEC 046 - Sensor sharing API'
  description: >
    The ETSI MEC ISG MEC046 Sensor sharing API described using OpenAPI
  license:
    name: BSD-3-Clause
    url: 'https://forge.etsi.org/legal-matters'

responses:
  '200':
    description: 'OK'
  '204':
    description: 'No Content'
  '400':
    description: 'Bad Request: used to indicate that incorrect parameters were passed to the request.'
    content:
      application/problem+json:
        schema:
          $ref: '#/components/schemas/ProblemDetails'
  '403':
    description: 'Forbidden: operation is not allowed given the current status of the resource.'
    content:
      application/problem+json:
        schema:
          $ref: '#/components/schemas/ProblemDetails'
  '404':
    description: 'Not Found: used when a client provided a URI that cannot be mapped to a valid resource URI.'
    content:
      application/problem+json:
        schema:
          $ref: '#/components/schemas/ProblemDetails'
  '412':
    description:
      'Precondition failed: used when a condition has failed during conditional requests, e.g. when
      using ETags to avoid write conflicts when using PUT'
    content:
      application/problem+json:
        schema:
          $ref: '#/components/schemas/ProblemDetails'
 No newline at end of file