OpenTravel Alliance · OpenAPI Overlay 1.0.0

API Evangelist enhancements for OpenTravel 2020A Facility Resource

4 actions 4 updates documentation extends openapi/opentravel-2020a-facility-resource-openapi.json
Generated by API Evangelist Written by API Evangelist tooling for OpenTravel Alliance's API. It is a proposal applied on top of the contract, not a document OpenTravel Alliance publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

tagsdescriptionx-apievangelist-operation-idx-apievangelist-operation-id-notex-apievangelist-providerx-apievangelist-artifact-kindx-apievangelist-runtime-operated-by-providerx-opentravel-release

Targets 4

$.info
$
$.paths['/Facilities'].post
$.paths['/Facilities/{Identifier}'].get

OpenAPI Overlay

Raw ↑ 
overlay: 1.0.0
info:
  title: API Evangelist enhancements for OpenTravel 2020A Facility Resource
  version: 1.0.0
extends: openapi/opentravel-2020a-facility-resource-openapi.json
x-generated: '2026-07-28'
x-method: generated
x-also-applies-to: openapi/opentravel-2020a-facility-resource-defs-openapi.json
x-note: >-
  Captures API Evangelist annotations for a specification artifact that OpenTravel does not
  operate. The original Swagger 2.0 document is never mutated. The `host` and `basePath` it
  declares (example.com/resource/v1_0) are placeholders emitted by the OTM compiler; an implementer
  substitutes its own. Overlay 1.0.0 targets are expressed against the document as-is.
actions:
- target: $.info
  update:
    x-apievangelist-provider: opentravel-alliance
    x-apievangelist-artifact-kind: specification-contract
    x-apievangelist-runtime-operated-by-provider: false
    x-opentravel-release: '2020A'
    x-opentravel-library: FacilityResource 1.0.0
    x-opentravel-library-status: DRAFT
    x-opentravel-compiled: '2020-05-15'
    x-apievangelist-json-schema-modules:
    - json-schema/opentravel-2020a-facility-resource-trim.schema.json
    - json-schema/opentravel-2020a-organization-4-1-0-trim.schema.json
    - json-schema/opentravel-2020a-common-5-0-0-trim.schema.json
- target: $
  update:
    x-apievangelist-host-note: >-
      Declared host `example.com` and schemes [http] are OTM compiler placeholders.
      Serve over HTTPS on your own host.
    x-apievangelist-security-note: >-
      No securityDefinitions are declared although 401 and 403 are returned by every
      operation. See authentication/opentravel-alliance-authentication.yml.
    x-apievangelist-conventions: conventions/opentravel-alliance-conventions.yml
    x-apievangelist-errors: errors/opentravel-alliance-problem-types.yml
- target: $.paths['/Facilities'].post
  update:
    tags:
    - Facility
    description: Add a facility to the facilities collection.
    x-apievangelist-operation-id: Post
    x-apievangelist-operation-id-note: >-
      operationId `Post` is unique only within this document; the OTM compiler emits
      bare verbs, so ids collide across OpenTravel resource contracts.
- target: $.paths['/Facilities/{Identifier}'].get
  update:
    tags:
    - Facility
    description: Retrieve a single facility by its externally-assigned identifier.
    x-apievangelist-operation-id: Get
    x-apievangelist-operation-id-note: >-
      operationId `Get` is unique only within this document; the OTM compiler emits
      bare verbs, so ids collide across OpenTravel resource contracts.