definitions.yaml

# OpenAPI version identifier - required for OpenAPI 3.0 domains
openapi: 3.0.0

#######################
# Optional info section
#######################
info:
  title: INGV Definitions
  description: Common components for INGV REST APIs
  version: '1.0.0'

components:

  ####################
  # Common data models
  ####################
  schemas:
    id:
      type: integer
      description: Unique incremental id | bigint(20)
      format: int64
      example: 14932631
    id__READONLY:
      type: integer
      description: Unique incremental id | bigint(20)
      format: int64
      readOnly: true
      example: 14932631
    modified:
      type: string
      format: date-time
      readOnly: true
      description: Last Review | timestamp
      example: '2016-06-22T16:52:06.260Z'
    inserted:
      type: string
      format: date-time
      readOnly: true
      description: Insert time | timestamp
      example: '2016-06-22T16:52:06.260Z'
    fk_type_origin:
      type: integer
      description: 'Link: type_origin | bigint(20)'
      format: int64
      example: 0
    fk_type_event:
      type: integer
      description: ' | bigint(20)'
      format: int64
      example: 697
      default: 1
    fk_provenance:
      type: integer
      description: 'Link: provenance | bigint(20)'
      format: int64
      example: 13
    id_localspace:
      type: integer
      description: Localspace Id | bigint(19)
      format: int64
      example: 182491
      default: null
      nullable: true
    id_localspace__WRITEONLY:
      type: integer
      description: Localspace Id | bigint(19)
      format: int64
      example: 182491
      default: null
      nullable: true
      writeOnly: true
    event__fk_event_group__READONLY:
      type: integer
      description: Link event group | bigint(20)
      format: int64
      readOnly: true
      default: 0
    event__fk_event_group:
      type: integer
      description: Link event group | bigint(20)
      format: int64
      default: 0
    event__fk_event_group__FOR_PATCH:
      type: integer
      description: Link event group | bigint(20)
      format: int64
    event__fk_origin_preferred__READONLY:
      type: integer
      description: 'Link: preferred origin. It can be NULL. | bigint(20)'
      format: int64
      readOnly: true
      default: null
      nullable: true
    event__fk_origin_preferred:
      type: integer
      description: 'Link: preferred origin. It can be NULL. | bigint(20)'
      format: int64
      default: null
      nullable: true
    event__fk_magnitude_preferred__READONLY:
      type: integer
      description: 'Link: preferred magnitude. It can be NULL. | bigint(20)'
      format: int64
      readOnly: true
      default: null
      nullable: true
    event__fk_magnitude_preferred:
      type: integer
      description: 'Link: preferred magnitude. It can be NULL. | bigint(20)'
      format: int64
      default: null
      nullable: true
    event__fk_focalmechanism_preferred__READONLY:
      type: integer
      description: 'Link: preferred focalmechanism. It can be NULL. | bigint(20)'
      format: int64
      readOnly: true
      default: null
      nullable: true
    event__fk_focalmechanism_preferred:
      type: integer
      description: 'Link: preferred focalmechanism. It can be NULL. | bigint(20)'
      format: int64
      default: null
      nullable: true
    event__type_group:
      type: integer
      description: Group type. Used by clustering algorithm | tinyint(4)
      format: int64
      readOnly: true
      default: 0
    origin__ot:
      type: string
      format: date-time
      description: Origin time | datetime(3)
      example: '2016-06-22T16:52:06.260Z'
    depth:
      type: number
      description: Depth in Km | double
      format: double
      example: 0.02
    status:
      #From here: $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/schemas/Problem/properties/status'
      description: |
        The HTTP status code generated by the origin server for this occurrence
        of the problem.
      example: 503
      exclusiveMaximum: true
      format: int32
      maximum: 600
      minimum: 100
      type: integer
    title:
      #From here: $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/schemas/Problem/properties/title'
      description: |
        A short, summary of the problem type. Written in english and readable
        for engineers (usually not suited for non technical stakeholders and
        not localized): the expressed pattern does not support unicode characters.
      example: Service Unavailable
      maxLength: 64
      pattern: ^[ -~]{0,64}$
      type: string
    detail:
      #From here: $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/schemas/Problem/properties/detail'    
      description: |
        A human readable explanation specific to this occurrence of the
        problem. You MUST NOT expose internal informations, personal
        data or implementation details through this field.

        `detail` supports localized patterns whereas `title` pattern is only in ascii.
      example: Request took too long to complete.
      maxLength: 4096
      pattern: ^.{0,1024}$
      type: string
    latitude:
      $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/schemas/Latitude'
    longitude:
      $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/schemas/Longitude'
    Problem:
      $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/schemas/Problem'
    standard_dev:
      type: number
      description: Standard deviation SQRT[ rms / (n - 1) ] | double
      format: double
      example: 0.53
    associatedPhaseCount:
      type: integer
      description: Number of associated phases, regardless of their use for origin computation | int(8)'
      format: int64
    associatedStationCount:
      type: integer
      description: Number of stations at which the event was observed | int(8)'
      format: int64
    usedPhaseCount:
      type: integer
      description: Number of defining phases, i.e., phase observations that were actually used for computing the origin | int(8)'
      format: int64
    usedStationCount:
      type: integer
      description: Number of stations from which data was used for origin computation | int(8)'
      format: int64
    origin__nph:
      type: integer
      description: '# arrivals (P&S) weight >0.1 | int(11)'
      format: int64
    origin__nph_s:
      type: integer
      description: '# S arrivals weight >0.1 | int(11)'
      format: int64
    origin__nph_tot:
      type: integer
      description: '# arrivals (P&S) weight >0.0 | int(11)'
      format: int64
    origin__nph_fm:
      type: integer
      description: '# P first motions | int(11)'
      format: int64
    origin__is_centroid:
      type: boolean      
      description: true if it is a centroi | boolean
      example: false
      default: false
    origin__sec_azim_gap:
      type: number
      description: Secondary Azimutal gap | double
      format: float
    origin__err_depth:
      type: number
      description: Depth error | double
      format: double
    origin__err_lat:
      type: number
      description: Latitude error (km) | double
      format: double
    origin__err_lon:
      type: number
      description: Longitude error (km) | double
      format: double
    err_lat_deg:
      type: number
      readOnly: true
      description: Latitude error (deg) | double
      format: double
    err_lon_deg:
      type: number
      readOnly: true
      description: Longitude error (deg) | double
      format: double
    azimutal_gap:
      type: number
      description: Azimutal gap | float4
      format: float
    origin__rms:
      type: number
      description: Root mean square | double
      format: double
    origin__e0_az:
      type: number
      description: azimuth of largest principal error | double
      format: float
    origin__min_distance:
      type: number
      description: Distance from the closest station (km) | double
      format: double
    origin__med_distance:
      type: number
      description: Median distance from the epicenter to the used stations (km) | double
      format: double
    origin__max_distance:
      type: number
      description: Distance from the furthest station (km) | double
      format: double      
    origin__w_rms:
      type: number
      description: Root mean square Weighted | double
      format: double
    origin__e0_dip:
      type: number
      description: dip of largest principal error | double
      format: double
    origin__e0:
      type: number
      description: largest principal error | double
      format: double
    origin__e1_az:
      type: number
      description: azimuth of intermediate principal error | double
      format: float
    origin__e1_dip:
      type: number
      description: dip of intermediate principal error | double
      format: double
    origin__e1:
      type: number
      description: intermed principal error | double
      format: double
    origin__e2_az:
      type: number
      description: azimuth of smallest principal error | double
      format: float
    origin__e2_dip:
      type: integer
      description: dip of smallest principal error | double
      format: int64
    origin__e2:
      type: number
      description: smallest principal error | double
      format: double        
    origin__err_h:
      type: number
      description: Horizontal error (km) | double
      format: double
    origin__err_z:
      type: number
      description: Depth error (km) | double
      format: double
    origin__err_ot:
      type: number
      description: Origin time error | double
      format: double
    origin__fix_depth:
      type: boolean      
      description: true if depth is fixed | boolean
      example: false
      default: false
    confidence_level:
      type: number
      description: Integer numer for confidence level type (68.3 1 sigma, xx =2 sigma, 99% 3 sigma) | decimal(5.2)
      format: float
      example: 68.3
      default: 68.3
    origin__quality:
      type: string
      description: Quality of the localization | char(2)
      example: AB
    origin__quality_numeric:
      type: integer
      description: Quality as numeric value | int(10)
      example: 12
      format: int64
    environment:
      description: Environment (es:development, testing, staging, production, external, catalog, generic) | varchar(255)
      type: string
      example: development
      default: development
      enum: 
        - development
        - testing
        - staging
        - production
        - external
        - catalog
        - generic
    type_origin__name:
      description: type_origin by QuakeML definition (es:hypocenter,centroid,macroseismic,..) | varchar(255)
      type: string
      example: hypocenter
      default: hypocenter
      enum: 
        - hypocenter
        - centroid
        - amplitude
        - macroseismic
        - rupture start
        - rupture end
    type_origin__version_name:
      description: Localization name (es:ew prelim,XX,WW,..) | varchar(255)
      type: string
      example: ew prelim
    type_origin__version_name__READONLY:
      description: Localization name (es:ew prelim,XX,WW,..) | varchar(255)
      type: string
      example: ew prelim
      readOnly: true
    ##########################
    ## Purtroppo ho dovuto duplicare questo campo in quanto se avessi usato l'ereditarieta tipo:
    #type_origin__version_value:
    #  readOnly: true
    #  allOf:
    #  - $ref: '#/components/schemas/type_origin__version_value'
    #
    ## poi la generazione della Classi Java da SwaggerHub non funzionava.
    ## Da riprovare piu' avanti.
    type_origin__version_value:     
      type: integer
      description: Define a numeric value for type origin. < 100 is automatic location | bigint(20)
      format: int64
    type_origin__version_value__READONLY:     
      type: integer
      description: Define a numeric value for type origin. < 100 is automatic location | bigint(20)
      format: int64
      readOnly: true
    ##########################
    description:
      type: string
      description: Additional information | char(255)
      example: Auto added
      default: null
      nullable: true
    description__READONLY:
      type: string
      description: Additional information | char(255)
      example: Auto added
      default: null
      nullable: true
      readOnly: true
    note:
      type: string
      description: Additional information | char(255)
      example: my note
      default: null
      nullable: true
    net:
      type: string
      description: Channel net code | char(2)
      example: IV
    sta:
      type: string
      description: Channel station code | varchar(5)
      example: ACER
    cha:
      type: string
      description: Channel code | char(3)
      example: HHZ
    loc:
      type: string
      description: Channel location | char(2)
      example: '00'
      default: '--'
    focalmechanism__strike1:
      type: integer
      format: int32      
      description: strike focal plane n.1 | int(10)
      example: 34
      nullable: true
    focalmechanism__dip1:
      type: integer
      format: int32      
      description: dip focal plane n.1 | int(10)
      example: 50
      nullable: true
    focalmechanism__rake1:
      type: integer
      format: int32      
      description: rake focal plane n.1 | int(10)
      example: 88
      nullable: true
    focalmechanism__strike2:
      type: integer
      format: int32      
      description: strike focal plane n.2 | int(10)
      example: 218
      nullable: true
    focalmechanism__dip2:
      type: integer
      format: int32      
      description: dip focal plane n.2 | int(10)
      example: 40
      nullable: true
    focalmechanism__rake2:
      type: integer
      format: int32      
      description: rake focal plane n.2 | int(10)
      example: 93
      nullable: true
    focalmechanism__azim_gap:
      type: number
      format: float      
      description: Largest azim gap as seen from epicenter | double(22)
      nullable: true
    focalmechanism__nsta_polarity:
      type: integer
      format: int32
      description: Number of station polarities used for determination | int(10)
      nullable: true
    focalmechanism__misfit:
      type: number
      format: double 
      description: Fraction of misfit polarities [0,1] | double(22)
      nullable: true
    focalmechanism__stdr:
      type: number
      format: double 
      description: Station distribution ratio parameter [0,1] | double(22)
      nullable: true
    focalmechanism__rms_ang_diff_acc_pref:
      type: number
      format: double 
      description: rms_ang_diff_acc_pref | double(22)
    focalmechanism__frac_acc_30deg_pref:
      type: number
      format: double 
      description: frac_acc_30deg_pref | double(22)
      nullable: true
    focalmechanism__quality:
      type: string
      description: quality | char(2)
      example: Ba
      default: null
      nullable: true
    url:
      type: string
      description: External URL Reference | varchar(512)
      example: 'http://mysite'
      default: null
      nullable: true
    momenttensor__scalarmoment:
      type: number
      format: double 
      description: Scalar moment as derived in moment tensor inversion. Unit, Nm | double(22)
      example: 16607495309062.705
      default: null
      nullable: true
    momenttensor__variance_reduction:
      type: number
      format: double 
      description: Variance reduction of moment tensor inversion, given in percent (Dreger 2003). This is a goodness-of-fit measure | double(22)
      example: 41.15
      default: null
      nullable: true
    momenttensor__double_couple:
      type: number
      format: double 
      description: Double couple parameter obtained from moment tensor inversion (decimal fraction between 0 and 1) | double(22)
      example: 0.76
      default: null
      nullable: true
    momenttensor__clvd:
      type: number
      format: double 
      description: CLVD (compensated linear vector dipole) parameter obtained from moment tensor inversion (decimal fraction between 0 and 1) | double(22)
      example: 0.24
      default: null
      nullable: true
    momenttensor__iso:
      type: number
      format: double
      description: Isotropic part obtained from moment tensor inversion (decimal fraction between 0 and 1) | double(22)
      example: 0
      default: null
      nullable: true
    momenttensor__mrr:
      type: number
      format: double
      description: mrr moment tensor component | double(22)
      example: 80.956
      default: null
      nullable: true
    momenttensor__mtt:
      type: number
      format: double
      description: mtt moment tensor component | double(22)
      example: -25.017
      default: null
      nullable: true
    momenttensor__mpp:
      type: number
      format: double
      description: mpp moment tensor component | double(22)
      example: -55.939
      default: null
      nullable: true
    momenttensor__mrt:
      type: number
      format: double
      description: mrt moment tensor component | double(22)
      example: 7.048
      default: null
      nullable: true
    momenttensor__mrp:
      type: number
      format: double
      description: mrp moment tensor component | double(22)
      example: 13.494
      default: null
      nullable: true
    momenttensor__mtp:
      type: number
      format: double
      description: mtp moment tensor component | double(22)
      example: -49.466
      default: null
      nullable: true
    magnitude:
      type: number
      description: Magnitude | double
      format: double
    magnitude__mag:
      type: number
      description: Magnitude value | double
      format: double
      example: 3.01
    magnitude__lower_uncertainty:
      type: number
      description: Magnitude lower_uncertainty | double
      format: double
      example: 0.52
    magnitude__upper_uncertainty:
      type: number
      description: Magnitude upper_uncertainty | double
      format: double
      example: 0.53
    magnitude__quality:
      type: number
      description: quality | double
      format: double
    magnitude__min_dist:
      type: number
      description: Minimal distance from station to origin | double
      format: double
    magnitude__nsta:
      type: integer
      description: Number of the stations on magnitudo calculation | int(11)
      format: int64
    magnitude__ncha:
      type: integer
      description: Number of the channel on magnitudo calculation | int(11)
      format: int64
    magnitude__nsta_used:
      type: integer
      description: Number of the stations used on magnitudo calculation | int(11)
      format: int64
      example: 9
    magnitude__ncha_used:
      type: integer
      description: Number of the channels used on magnitude calculation | int(11)
      format: int64
      example: 27
    magnitude__mag_quality:
      type: string
      description: INGV quality code of the magnitude (computed by ew2moledb) | char(2)
      example: BB
    scnl__net:
      type: string
      description: Channel net code | char(2)
      example: IV
    scnl__sta:
      type: string
      description: Channel station code | varchar(5)
      example: ACER
    scnl__cha:
      type: string
      description: Channel code | char(3)
      example: HHZ
    scnl__loc:
      type: string
      description: Channel location | char(2)
      example: '00'
      default: '--'
    scnl__lat:
      type: number
      format: double
      description: latitude | float(8,8)
      example: -19.755530
    scnl__lon:
      type: number
      format: double
      description: longitude | float(8,8)
      example: 63.370140
    scnl__elev:
      type: number
      format: double
      description: elevation | float(8,8)
      example: 19.1
    pick__arrival_time:
      type: string
      format: date-time
      description: Arrival time with microseconds | datetime(3)
      example: '2017-04-12T08:46:30.930Z'
    pick__pick_quality_class:
      type: integer
      description: Pick quality class | bigint
      format: int32
      example: 3
    pick__lower_uncertainty:
      type: number
      description: Uncertainty as the absolute value of deviation from the mainvalue towards smaller values. | decimal(8,3)
      format: float
      example: 0.52
      default: null
      nullable: true
    pick__upper_uncertainty:
      type: number
      description: Uncertainty as the absolute value of deviation from the mainvalue towards larger values. | decimal(8,3)
      format: float
      example: 0.53
      default: null
      nullable: true
    pick__firstmotion:
      type: string
      nullable: true
      description: First motion polarity associated with the pick | varchar(1)
      example: D
      default: null
      enum: 
        - U
        - D
        - null
    pick__emersio:
      type: string
      nullable: true
      description: Impulsive or emersio, pamp description | varchar(1)
      example: E
      default: null
      enum: 
        - E
        - I
        - null
    pickew__pamp:
      type: number
      description: peak P-wave half amplitude | double(22)
      format: float
      example: 283
      default: null
      nullable: true
    pick_ew_coda__ccntr_0:
      type: integer
      description: peak P-wave half amplitude | int(11)
      format: int64
    pick_ew_coda__ccntr_1:
      type: integer
      description: peak P-wave half amplitude | int(11)
      format: int64
    pick_ew_coda__ccntr_2:
      type: integer
      description: peak P-wave half amplitude | int(11)
      format: int64
    pick_ew_coda__ccntr_3:
      type: integer
      description: peak P-wave half amplitude | int(11)
      format: int64
    pick_ew_coda__ccntr_4:
      type: integer
      description: peak P-wave half amplitude | int(11)
      format: int64
    pick_ew_coda__ccntr_5:
      type: integer
      description: peak P-wave half amplitude | int(11)
      format: int64
    pick_ew_coda__caav_0:
      type: integer
      description: peak P-wave half amplitude | int(11)
      format: int64
    pick_ew_coda__caav_1:
      type: integer
      description: peak P-wave half amplitude | int(11)
      format: int64
    pick_ew_coda__caav_2:
      type: integer
      description: peak P-wave half amplitude | int(11)
      format: int64
    pick_ew_coda__caav_3:
      type: integer
      description: peak P-wave half amplitude | int(11)
      format: int64
    pick_ew_coda__caav_4:
      type: integer
      description: peak P-wave half amplitude | int(11)
      format: int64
    pick_ew_coda__caav_5:
      type: integer
      description: peak P-wave half amplitude | int(11)
      format: int64
    arrival__isc_code:
      type: string
      description: ISC arrival code | varchar(8)
      example: S
    type_magnitude__name:
      type: string
      description: Type of the magnitude | varchar(255)
      example: ML-VAX
    type_magnitude__minmag:
      type: number
      format: float
      description: Minimum magnitude value | float(4)
      example: 1.2
    type_magnitude__maxmag:
      type: number
      format: float
      description: Maximum magnitude value | float(4)
      example: 2.2
    type_magnitude__minreadings:
      type: integer
      format: int32
      description: Minimum number of readings | int(8)
    origin_flag__name:
      type: string
      description: Flag name | varchar(255)
      example: DPC
    origin_flag__value:
      type: number
      format: float
      description: Value associated to the flag | int
      example: 1
    arrival-stationmagnitude-st_dur_mag__ep_distance:
      type: number
      description: Distance from epicenter of the station | double
      format: float
      example: 694
    arrival-stationmagnitude-st_dur_mag__azimut:
      type: number
      description: Station origin azimut | double
      format: float
      example: 161
    arrival-stationmagnitude-st_dur_mag__orig_distance_km:
      type: number
      description: Distance from origin of the station (km) | double
      format: double
      example: 161
      default: null
      nullable: true
    arrival__take_off:
      type: number
      description: Take off angle | double
      format: float
      example: 94
    arrival__polarity_is_used:
      type: boolean      
      description: 1 if it is used for polarity calculation | boolean
      example: false
      default: null
      nullable: true
    arrival__arr_time_is_used:
      type: boolean
      description: 1 if it is used for origin calculation | boolean
      example: false
      default: null
      nullable: true
    arrival__residual:
      type: number
      description: Residual | double
      format: double
      example: 6.19
    weight:
      type: number
      description: Weight | double
      format: double
      example: 0.88
    stationmagnitude-st_dur_mag__polarity_is_used:
      type: boolean
      description: true if used | boolean
      example: false
      default: false
    st_dur_mag__dur:
      type: number
      description: ' Coda duration in seconds | double'
      format: double
      example: 6
    st_dur_mag__mag:
      type: number
      description: Duration magnitude value | double
      format: double
      example: 0.8
    stationmagnitude__mag:
      type: number
      description: Amplitude magnitude value | double
      format: double
      example: 3.04
    stationmagnitude__mag_correction:
      type: number
      description: magnitude correction | double
      format: double
      example: 0
    stationmagnitude-st_dur_mag__err_mag:
      type: number
      description: magnitude error | double
      format: double
    ep_distance_km:
      type: number
      description: Distance from epicenter of the station expressed in Km | double
      format: float
      example: 223.3
    orig_distance_km:
      type: number
      description: Distance from ipocenter of the station expressed in Km | double
      format: float
      example: 253.3
    ep_distance_delta:
      type: number
      description: Distance from epicenter of the station expressed in Degrees | double
      format: float
      example: 2      
    amplitude__time1:
      type: string
      format: date-time
      description: ' | datetime(3)'
      example: '2017-04-28T06:34:15.350Z'
    amplitude__amp1:
      type: number
      description: Amplitude value | double
      format: double
      example: -0.358
    amplitude__period:
      type: number
      description: Amlitude period | double
      format: double
    amplitude__time2:
      type: string
      format: date-time
      description: ' | datetime(3)'
      example: '2017-04-28T06:34:15.850Z'
    amplitude__amp2:
      type: number
      description: Amplitude value | double
      format: double
      example: 0.292
    amplitude__revised:
      type: integer
      description: Dichiara se tale ampiezza è stata rivista dall'analista, eventualmente anche non modificata, oppure no. (1/0, true/false) | tinyint(3)
      format: int32
      example: 0
    strongmotion__t_dt:
      type: string
      format: date-time
      description: 'time: trigger reported by SM box - datetime part | datetime(6)'
      example: '2017-04-12T08:46:56.190Z'
    strongmotion__pga:
      type: number
      description: 'REQUIRED: peak ground acceleration (cm/s/s) | double'
      format: float
      example: 0.000162
    strongmotion__tpga_dt:
      type: string
      format: date-time
      description: 'OPTIONAL: time of pga - datetime part | datetime(3)'
      example: '2017-04-12T08:47:06.990Z'
    strongmotion__pgv:
      type: number
      description: 'REQUIRED: peak ground velocity (cm/s) | double'
      format: float
      example: 0.000034
    strongmotion__tpgv_dt:
      type: string
      format: date-time
      description: 'OPTIONAL: time of pgv - datetime part | datetime(3)'
      example: '2017-04-12T08:46:56.190Z'
    strongmotion__pgd:
      type: number
      description: 'REQUIRED: peak ground displacement (cm) | double'
      format: float
      example: 0.000025
    strongmotion__tpgd_dt:
      type: string
      format: date-time
      description: 'OPTIONAL: time of pgd - datetime part | datetime(3)'
      example: '2017-04-12T08:46:59.989Z'
    strongmotion__rsa_030:
      type: number
      format: float
      description: RSA(response spectrum accel) value for period 0.30 | double
      example: 0.02604
    strongmotion__rsa_100:
      type: number
      format: float
      description: RSA(response spectrum accel) value for period 1.00 | double
      example: 0.003673
    strongmotion__rsa_300:
      type: number
      format: float
      description: RSA(response spectrum accel) value for period 3.00 | double
      example: 0.000339
    strongmotion_alt__t_alt_dt:
      type: string
      format: date-time
      description: 'alternate time: trigger reported by SM box - time with microseconds | datetime(3)'
    strongmotion_alt__altcode:
      type: integer
      format: int64
      description: code specifying the source of the alternate time field | int(11)
      example: 0
    strongmotion_rsa__value:
      type: number
      format: double
      description: RSA value (cm/s/s) at given period | double
      example: 1.5
    strongmotion_rsa__period:
      type: number
      format: double
      description: period (s) at which RSA values are given | double
      example: 0.000096
    type_event__name:
      type: string
      description: Name | varchar(255)
      example: earthquake     
    origin_region_name__region:
      type: string
      description: Event location remark region | varchar(255)
      example: Norcia
    flags:
      type: string
      description: Flags for origin | varchar(255)
      readOnly: true
      example: DPC,twitter,shakemap4,FM
    localspace__name:
      type: string
      description: 'Localspace name. i.e. hew1_mole, endeavour_mole | char(255)'
      example: hew1_mole
    provenance__model:
      type: string
      description: Name/URI/DOI of the model | varchar(255)
      example: prem
      default: null
      nullable: true
    provenance__parameters:
      type: string
      description: Name/URI/DOI of the parameters | varchar(255)
      example: ToDo
      default: null
      nullable: true
    provenance__version:
      type: string
      description: Version name | varchar(255)
      example: hew1_mole
    provenance__softwarename:
      type: string
      description: 'Software name. i.e. SisPick, eqassemble, hypoinverse | char(255)'
      example: software
    provenance__username:
      type: string
      description: User name | char(255)
      example: ew
      default: null
      nullable: true
    provenance__hostname:
      type: string
      description: Hostname | char(255)
      example: hew10.ingv.it
      default: null
      nullable: true
    priority:
      type: integer
      description: Priority | int(8)
      format: int64
      example: 0
      default: 0
    priority__READONLY:
      type: integer
      description: Priority | int(8)
      format: int64
      readOnly: true
      example: 0
      default: 0
    provenance__former_id:
      type: integer
      description: ToDo | int(8)
      format: int64
      example: 1
      default: 0
    provenance__name:
      type: string
      description: 'Name of Provenance. i.e. INGV, ETH, USGS | varchar(255)'
      example: INGV
      default: INGV
    provenance__program:
      type: string
      description: Name/URI/DOI of the program | varchar(255)
      example: IPO-EW__tdmt_invc.c
    provenance__method:
      type: string
      description: Name/URI/DOI of the method | varchar(255)
      example: ToDo
      default: null
      nullable: true
    provenance__evaluationmode:
      description: Evaluation Mode by QuakeML definition (es:manual,automatic)
      type: string
      example: automatic
      default: null
      enum: 
        - automatic
        - manual
        - null
    doi:
      type: string
      description: 'DOI Resource. i.e. 10.13127/TDMT | varchar(255)'
      example: 10.13127/TDMT
    type_amplitude__name:
      type: string
      description: Type of the amplitude | varchar(50)
      example: Acceleration
    type_amplitude__unit:
      type: string
      description: Unit of measurement of type amplitude | varchar(255)
      example: m/s        
      default: null
      nullable: true    
    type_amplitude__category:
      description: The way the waveform trace is evaluated to derive an amplitude value; from QuakeML. (es:point,mean,duration,period,..) | varchar(255)
      type: string
      example: other
      default: null
      nullable: true
      enum: 
        - point
        - mean
        - duration
        - period
        - integral
        - other
        - null
    type_momenttensor__name:
      type: string
      description: Type of Moment Tensor | varchar(50)
      example: TDMT
    municipio__name:
      type: string
      description: Italian "municipio" name.
      example: 'Ladispoli'
    municipio__sigla_pro:
      type: string
      description: Italian province abbreviation.
      example: 'RM'
    municipio__prov_name:
      type: string
      description: Italian province name.
      example: 'Roma'
    municipio__region_name:
      type: string
      description: Italian region name.
      example: 'Lazio'
    municipio__population:
      type: integer
      format: int64
      description: Popolazione.
      example: 41078

  ####################
  # Common parameters
  ####################
  parameters:
    level:
      name: level
      in: query
      description: Select deep level
      required: false
      schema:
          type: string
          enum: [event, origin, magnitude, all]
          default: all
    orderby:
      name: orderby
      in: query
      description: Select "order by"; multiple "order" contatenation available (i.e. event_id-desc,type_origin_version_value-asc)
      required: false
      schema:
          type: string
          format: string
    fk_event_group:
        name: event_group_id
        in: query
        description: Select events with same event_group_id.
        required: false
        schema:
            type: integer
            format: int64
    id_localspace:
        name: id_localspace
        in: query
        description: Localspace Id.
        required: false
        schema:
            type: integer
            format: int64
    originid:
        name: originid
        in: query
        description: Select by origin id.
        required: false
        schema:
          type: integer
          format: int64
    magnitudeid:
        name: magnitudeid
        in: query
        description: Select by magnitude id.
        required: false
        schema:
          type: integer
          format: int64 
    starttime:
        description: Select date start (i.e. 2016-06-22T16:52:06.260Z).
        in: query
        name: starttime
        required: false
        schema:
          type: string
          format: date-time
    starttime__REQUIRED:
        description: Select date start (i.e. 2016-06-22T16:52:06.260Z).
        in: query
        name: starttime
        required: true
        schema:
          type: string
          format: date-time
    endtime:
        description: Select date end (i.e. 2016-06-22T16:52:06.260Z).
        in: query
        name: endtime
        required: false
        schema:
          type: string
          format: date-time
    endtime__REQUIRED:
        description: Select date end (i.e. 2016-06-22T16:52:06.260Z).
        in: query
        name: endtime
        required: true
        schema:
          type: string
          format: date-time
    orpolygon:
      name: orpolygon
      in: query
      description: |-
        Specify a list of polygons to select data. 

        Each polygon is `|` separated values, with counterclockwise values like `<lon>,<lat>` and last couple must be like the first one.

        * Example: `orpolygon=12,42,13,42,13,43,12,43,12,42|12.3,42.3,13.3,42.3,13.3,43.3,12.3,43.3,12.3,42.3`.
      required: false
      schema:
        format: string
        type: string
      style: form
    notinpolygon:
      name: notinpolygon
      in: query
      description: |-
        Specify a list of polygons to NOT select data within. 
        
        Each polygon is `|` separated values, with counterclockwise values like `<lon>,<lat>` and last couple must be like the first one.
        
        * Example: `notinpolygon=12.5,42,12.5,43,13,48,12.5,42|12.2,41.8,13.2,41.8,13.2,42.8,12.2,42.8,12.2,41.8`
      required: false
      schema:
        format: string
        type: string
      style: form
    wherepolygonnamein:
      name: wherepolygonnamein
      in: query
      explode: false
      required: false
      description: |-
        Specify a list of pre-set polygons. 
        
        Each polygon is `,` separated value.
        
        * Example: `wherepolygonnamein=area_confine_italia,area_vulcanica_italia`
      schema:
        type: array
        items:
          type: string
          enum: [settore_1_pol, settore_2_pol, settore_cat_pol, aree_vulcaniche_italia_2020, ov_aree_vulcani_mari, area_vulcanica_italia, area_confine_italia]
      style: form
    minlat:
        description: Specify southern boundary for search in WGS84 (i.e. 39.12).
        in: query
        name: minlat
        required: false
        schema:
            $ref:  '#/components/schemas/latitude'
    maxlat:
        description: Specify northern boundary for search in WGS84 (i.e. 46.52).
        in: query
        name: maxlat
        required: false
        schema:
            $ref:  '#/components/schemas/latitude'
    minlon:
        description: Specify western boundary for search in WGS84 (i.e. 10.12).
        in: query
        name: minlon
        required: false
        schema:
            $ref:  '#/components/schemas/longitude'
    maxlon:
        description: Specify eastern boundary for search (in WGS84) (i.e. 15.12).
        in: query
        name: maxlon
        required: false
        schema:
            $ref:  '#/components/schemas/longitude'
    lat:
        description: Specify the central latitude point for a radial search in WGS84 (i.e. 42).
        in: query
        name: lat
        required: false
        schema:
            $ref:  '#/components/schemas/latitude'
    lon:
        description: Specify the central longitude point for a radial search in WGS84 (i.e. 12).
        in: query
        name: lon
        required: false
        schema:
            $ref:  '#/components/schemas/longitude'
    minradius:
        description: Specify minimum distance from the geographic point defined by latitude and longitude in Degrees (i.e. 1.5).
        in: query
        name:  minradius
        required: false
        schema:
            type: number
            format: double
    maxradius:
        description: Specify maximum distance from the geographic point defined by latitude and longitude in Degrees (i.e. 5).
        in: query
        name:  maxradius
        required: false
        schema:
            type: number
            format: double
    minradiuskm:
        description: Specify minimum distance from the geographic point defined by
            latitude and longitude. Kilometers.
        in: query
        name:  minradiuskm
        required: false
        schema:
            type: number
            format: double
    maxradiuskm:
        description: Specify maximum distance from the geographic point defined by
            latitude and longitude. Kilometers.
        in: query
        name:  maxradiuskm
        required: false
        schema:
            type: number
            format: double
    mindepth:
        description: Specify minimum depth (kilometers), values increase positively with depth (i.e. 0).
        in: query
        name:  mindepth
        required: false
        schema:
            format: double
            type: number
    maxdepth:
        description: Specify maximum depth (kilometers), values increase positively with depth (i.e. 50).
        in: query
        name:  maxdepth
        required: false
        schema:
            format: double
            type: number
    minnphtot:
        description: Specify minimum number of phases (P&S) with weight > 0.0.
        in: query
        name:  minnphtot
        required: false
        schema:
            format: int32
            type: integer
    mintypeoriginvalue:
        description: Filter the output to type_origin.version_value (i.e. 0).
        in: query
        name: mintypeoriginvalue
        required: false
        schema:
            $ref:  '#/components/schemas/type_origin__version_value'        
    maxtypeoriginvalue:
        description: Filter the output to type_origin.version_value (i.e. 1000).
        in: query
        name: maxtypeoriginvalue
        required: false
        schema:
            $ref:  '#/components/schemas/type_origin__version_value'
    minmag:
        description: Limit to events with a magnitude larger than or equal to the specified minimum (i.e. 1.5).
        in: query
        name: minmag
        required: false
        schema:
            $ref:  '#/components/schemas/magnitude'
    maxmag:
        description: Limit to events with a magnitude smaller than or equal to the specified maximum (i.e. 7.3).
        in: query
        name: maxmag
        required: false
        schema:
            $ref:  '#/components/schemas/magnitude'
    net__REQUIRED:
        description: Network
        in: query
        name:  net
        required: true
        schema:
            format: string
            type: string
    sta__REQUIRED:
        description: Station
        in: query
        name:  sta
        required: true
        schema:
            format: string
            type: string
    cha__REQUIRED:
        description: Channel
        in: query
        name:  cha
        required: true
        schema:
            format: string
            type: string
    loc:
        description: Location
        in: query
        name:  loc
        required: false
        schema:
            format: string
            type: string            
    limit:
        description: Limit the results to the specified number of records.
        in: query
        name:  limit
        required: false
        schema:
            format: int32
            type: integer
    page:
        description: Pagination.
        in: query
        name:  page
        required: false
        schema:
            format: int32
            type: integer
    offset:
      description: Return results starting at the event count specified.
      in: query
      name:  offset
      required: false
      schema:
        type: number
        format: int32
    updatedafter:
      description: Limit data to "updated after" params.
      in: query
      name:  updatedafter
      required: false
      schema:
        type: string
        format: date-time
    #updatedafterincolumn:
    #  description: Set the column to apply "updatedafter" filter (i.e. "origin" means "origin.modified"); default "all".
    #  in: query
    #  name: updatedafterincolumn
    #  required: false
    #  schema:
    #    type: string
    #    enum: [event, origin, magnitude, all]
    #    default: all
    eventupdatedafter:
      description: Limit data to "event.modified" after; if "originupdatedafter" and/or "magnitudeupdatedafter" are set, the "updatedafteroperator" is used.
      in: query
      name:  eventupdatedafter
      required: false
      schema:
        type: string
        format: date-time
    originupdatedafter:
      description: Limit data to "origin.modified" after; if "eventupdatedafter" and/or "magnitudeupdatedafter" are set, the "updatedafteroperator" is used.
      in: query
      name:  originupdatedafter
      required: false
      schema:
        type: string
        format: date-time
    magnitudeupdatedafter:
      description: Limit data to "magnitude.modified" after; if "eventupdatedafter" and/or "originupdatedafter" are set, the "updatedafteroperator" is used.
      in: query
      name:  magnitudeupdatedafter
      required: false
      schema:
        type: string
        format: date-time
    updatedafteroperator:
      description: Set the "operator" to use when "eventupdatedafter", "originupdatedafter" and "magnitudeupdatedafter" are set.
      in: query
      name: updatedafteroperator
      required: false
      schema:
        type: string
        enum: [and, or]
        default: or
    mindistance:
        description: Specify minimum distance from the closest station (kilometers).
        in: query
        name:  mindistance
        required: false
        schema:
            type: number
            format: double
    mindistance__REQUIRED:
        description: Specify minimum distance (kilometers).
        in: query
        name:  mindistance
        required: true
        schema:
            format: double
            type: number
    maxdistance__REQUIRED:
        description: Specify maximum distance (kilometers).
        in: query
        name:  maxdistance
        required: true
        schema:
            format: double
            type: number       
    minpopolazione__REQUIRED:
        description: Specify minimum popolazione.
        in: query
        name:  minpopolazione
        required: true
        schema:
            format: int64
            type: integer
    municipio__REQUIRED:
        description: Specify the Italian "municipio" name.
        in: query
        name:  name
        required: true
        schema:
            format: string
            type: string
    eventid:
      description: Select by event id.
      in: query
      name:  eventid
      required: false
      schema:
        type: integer
        format: int64
    eventid__required:
      description: Select by event id.
      in: query
      name:  eventid
      required: true
      schema:
        type: integer
        format: int64
    includeallorigins:
      description: Is used to retrive all origins associated with each event.
      in: query
      name:  includeallorigins
      required: false
      schema:
        type: boolean
        default: false
    includeallmagnitudes:
      description: Is used to retrive all magnitudes associated with each event.
      in: query
      name:  includeallmagnitudes
      required: false
      schema:
        type: boolean
        default: false
    includeallstationsmagnitudes:
      description: Is used to retrive all stations magnitudes associated with each origin.
      in: query
      name:  includeallstationsmagnitudes
      required: false
      schema:
        type: boolean
        default: false
    includearrivals:
      description: Is used to retrive any associated arrival information for each event.
      in: query
      name:  includearrivals
      required: false
      schema:
        type: boolean
        default: false
    origindirectlinktoevent:
      description: Origin entity is directly linked to Event entity (`origin.fk_event=event.id`)
      in: query
      name:  origindirectlinktoevent
      required: false
      schema:
        type: boolean
        default: false
    magnitudedirectlinktoorigin:
      description: Magnitude entity is directly linked to Origin entity (`magnitude.fk_origin=origin.id`)
      in: query
      name:  magnitudedirectlinktoorigin
      required: false
      schema:
        type: boolean
        default: false
    magnitudedirectlinktoevent:
      description: Magnitude entity is directly linked to Event entity `(magnitude.fk_origin=origin.id AND origin.fk_event=event.id`)
      in: query
      name:  magnitudedirectlinktoevent
      required: false
      schema:
        type: boolean
        default: false
    doi:
      name: doi
      description: Doi.
      explode: false
      in: query
      required: false
      schema:
        type: string
        format: string
##########
    wherelocalspaceenvironmentin:
      name: wherelocalspaceenvironmentin
      description: Filter by "localspace.environment" by comma separated value (i.e. development,staging).
      explode: false
      in: query
      required: false
      schema:
        type: array
        items:
          type: string
          enum: [development, testing, staging, production, external, catalog, generic]
    whereeventlocalspaceenvironmentin:
      name: whereeventlocalspaceenvironmentin
      description: Filter by "event.localspace.environment" by comma separated value (i.e. development,staging); this parameter is in "OR" with "whereoriginlocalspaceenvironmentin" and "wheremagnitudelocalspaceenvironmentin".
      explode: false
      in: query
      required: false
      schema:
        type: array
        items:
          type: string
          enum: [development, testing, staging, production, external, catalog, generic]
    whereoriginlocalspaceenvironmentin:
      name: whereoriginlocalspaceenvironmentin
      description: Filter by "origin.localspace.environment" by comma separated value (i.e. development,staging); this parameter is in "OR" with "whereeventlocalspaceenvironmentin" and "wheremagnitudelocalspaceenvironmentin".
      explode: false
      in: query
      required: false
      schema:
        type: array
        items:
          type: string
          enum: [development, testing, staging, production, external, catalog, generic]
    wheremagnitudelocalspaceenvironmentin:
      name: wheremagnitudelocalspaceenvironmentin
      description: Filter by "magnitude.localspace.environment" by comma separated value (i.e. development,staging); this parameter is in "OR" with "whereeventlocalspaceenvironmentin" and "whereoriginlocalspaceenvironmentin".
      explode: false
      in: query
      required: false
      schema:
        type: array
        items:
          type: string
          enum: [development, testing, staging, production, external, catalog, generic]
##########
    wherelocalspacenamein:
      name: wherelocalspacenamein
      description: Filter by "localspace.name" by comma separated value (i.e. hew10_mole,hew20_mole).
      explode: false
      in: query
      required: false
      schema:
        type: string
        format: string
    whereeventlocalspacenamein:
      name: whereeventlocalspacenamein
      description: Filter by "event.localspace.name" by comma separated value (i.e. hew10_mole,hew20_mole); this parameter is in "OR" with "whereoriginlocalspacenamein" and "wheremagnitudelocalspacenamein".
      explode: false
      in: query
      required: false
      schema:
        type: string
        format: string
    whereoriginlocalspacenamein:
      name: whereoriginlocalspacenamein
      description: Filter by "origin.localspace.name" by comma separated value (i.e. hew10_mole,hew20_mole); this parameter is in "OR" with "whereeventlocalspacenamein" and "wheremagnitudelocalspacenamein".
      explode: false
      in: query
      required: false
      schema:
        type: string
        format: string
    wheremagnitudelocalspacenamein:
      name: wheremagnitudelocalspacenamein
      description: Filter by "magnitude.localspace.name" by comma separated value (i.e. hew10_mole,hew20_mole); this parameter is in "OR" with "whereeventlocalspacenamein" and "whereoriginlocalspacenamein".
      explode: false
      in: query
      required: false
      schema:
        type: string
        format: string
##########
    wherenetin:
      name: wherenetin
      description: Filter by multiple "net", comma separated value (i.e. IV,MN).
      explode: false
      in: query
      required: false
      schema:
        type: string
        format: string

    wherestain:
      name: wherestain
      description: Filter by multiple "sta", comma separated value (i.e. ACER,BADI).
      explode: false
      in: query
      required: false
      schema:
        type: string
        format: string

    wherechain:
      name: wherechain
      description: Filter by multiple "cha", comma separated value (i.e. HHZ,HHE).
      explode: false
      in: query
      required: false
      schema:
        type: string
        format: string

    wherelocin:
      name: wherelocin
      description: Filter by multiple "loc", comma separated value (i.e. 00,01,--).
      explode: false
      in: query
      required: false
      schema:
        type: string
        format: string
##########
    whereoriginqualityin:
      name: whereoriginqualityin
      description: Filter by "origin.quality" by comma separated value (i.e. AA,AB,BC).
      explode: false
      in: query
      required: false
      schema:
        type: array
        items:
          type: string
          enum: [AA, AB, AC, AD, BA, BB, BC, BD, CA, CB, CC, CD, DA, DB, DC, DD]
    wheretypeeventnamein:
      name: wheretypeeventnamein
      description: Filter by "event.type_event" by comma separated value (i.e. earthquake,not reported,collapse,explosion).
      explode: false
      in: query
      required: false
      schema:
        type: array
        items:
          type: string
          enum: [earthquake,not reported,anthropogenic event,collapse,cavity collapse,mine collapse,building collapse,explosion,accidental explosion,chemical explosion,controlled explosion,experimental explosion,industrial explosion,mining explosion,quarry blast,road cut,blasting levee,nuclear explosion,induced or triggered event,rock burst,reservoir loading,fluid injection,fluid extraction,crash,plane crash,train crash,boat crash,other event,atmospheric event,sonic boom,sonic blast,acoustic noise,thunder,avalanche,snow avalanche,debris avalanche,hydroacoustic event,ice quake,slide,landslide,rockslide,meteorite,volcanic eruption,not existing,testing,duplicate earthquake]
    wheretypeeventnamenotin:
      name: wheretypeeventnamenotin
      description: Filter by "event.type_event" - not in - by comma separated value (i.e. earthquake,not reported,collapse,explosion).
      explode: false
      in: query
      required: false
      schema:
        type: array
        items:
          type: string
          enum: [earthquake,not reported,anthropogenic event,collapse,cavity collapse,mine collapse,building collapse,explosion,accidental explosion,chemical explosion,controlled explosion,experimental explosion,industrial explosion,mining explosion,quarry blast,road cut,blasting levee,nuclear explosion,induced or triggered event,rock burst,reservoir loading,fluid injection,fluid extraction,crash,plane crash,train crash,boat crash,other event,atmospheric event,sonic boom,sonic blast,acoustic noise,thunder,avalanche,snow avalanche,debris avalanche,hydroacoustic event,ice quake,slide,landslide,rockslide,meteorite,volcanic eruption,not existing,testing,duplicate earthquake]
    wheremagnitudemagqualityin:
      name: wheremagnitudemagqualityin
      description: Filter by "magnitude.mag_quality" by comma separated value (i.e. A,B,BC,DD).
      explode: false
      in: query
      required: false
      schema:
        type: array
        items:
          type: string
          enum: [A, B, C, D, AA, AB, AC, AD, BA, BB, BC, BD, CA, CB, CC, CD, DA, DB, DC, DD]
    whereflagsin:
      description: Filter flags by comma separated values (i.e. DPC,twitter,shakemap4); values are in "OR".
      in: query
      name: whereflagsin
      required: false
      schema:
        type: string
        format: string
    wheretypeoriginvaluein:
      description: Filter by type_origin.version_value (i.e. 0,1,200).
      in: query
      name: wheretypeoriginvaluein
      required: false
      schema:
        type: string
        format: string
    wheretypemagnitudenameregexp:
      description: Filter by type_magnitude.name using case-insensitive regexp (i.e. "^ml.\*" or "^ml.*|^mwp$").
      in: query
      allowReserved: true
      name: wheretypemagnitudenameregexp
      required: false
      schema:
        type: string
        format: string

  #######################
  # Common request bodies
  #######################


  ####################
  # Common responses
  ####################
  responses:
    204NoContent:
      description: Request was properly formatted and submitted but no data matches the selection
    400BadRequest:
      $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/responses/400BadRequest'
    404NotFound:
      $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/responses/404NotFound'
    401Unauthorized:
      content:
        application/problem+json:
          schema:
            $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/schemas/Problem'
      description: Unauthorized
    403Forbidden:
      content:
        application/problem+json:
          schema:
            $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/schemas/Problem'
      description: Forbidden
    422UnprocessableEntity:
      content:
        application/problem+json:
          schema:
            $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/schemas/Problem'
      description: Unprocessable Entity    
    429TooManyRequests:
      $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/responses/429TooManyRequests'
    500InternalServerError:
      content:
        application/problem+json:
          schema:
            $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/schemas/Problem'
      description: Internal Server Error
    503ServiceUnavailable:
      $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/responses/503ServiceUnavailable'
    default:
      $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/responses/default'

  #########################
  # Common headers
  # (except request headers - they are defined as parameters)
  #########################
  headers:
    Cache-Control:
      description: no-store
      schema:
        type: string
    Retry-After:
      $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/headers/Retry-After'
    X-RateLimit-Limit:
      $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/headers/X-RateLimit-Limit'
    X-RateLimit-Reset:
      $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/headers/X-RateLimit-Reset'
    X-RateLimit-Remaining:
      $ref: 'https://teamdigitale.github.io/openapi/v0.1.0/definitions.yaml#/components/headers/X-RateLimit-Remaining'

  #######################
  # Common path items
  #######################
  #pathitems:

  ######################################
  # Common examples of input/output data
  ######################################
  #example:

  #########################
  # Common link definitions
  # See: https://swagger.io/docs/specification/links/
  #########################
  links: {}

  #########################
  # Common callback definitions
  # See: https://swagger.io/docs/specification/callbacks/
  #########################
  callbacks: {}