OpenTravel Alliance · OpenAPI Overlay 1.0.0

API Evangelist enhancements for OpenTravel 2018A Facility Resource

5 actions 5 updates documentation extends openapi/opentravel-2018a-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 5

$.info
$
$.paths['/HospitalityFindHospitalityAvailability'].post
$.paths['/HospitalityRetrieveFacilityAvailability'].post
$.paths['/Facilities'].post

OpenAPI Overlay

Raw ↑ 
overlay: 1.0.0
info:
  title: API Evangelist enhancements for OpenTravel 2018A Facility Resource
  version: 1.0.0
extends: openapi/opentravel-2018a-facility-resource-openapi.json
x-generated: '2026-07-28'
x-method: generated
x-also-applies-to: openapi/opentravel-2018a-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 (127.0.0.1/) 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: '2018A'
    x-opentravel-library: HospitalityFacility 1.0.0
    x-opentravel-library-status: FINAL
    x-opentravel-compiled: '2018-04-05'
    x-apievangelist-json-schema-modules:
    - json-schema/opentravel-2018a-hospitality-facility-trim.schema.json
- target: $
  update:
    x-apievangelist-host-note: >-
      Declared host `127.0.0.1` 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['/HospitalityFindHospitalityAvailability'].post
  update:
    tags:
    - Hospitality Facility
    description: Find hospitality facility availability.
    x-apievangelist-operation-id: FindHospitalityAvailability
    x-apievangelist-operation-id-note: >-
      operationId `FindHospitalityAvailability` is unique only within this document; the OTM compiler emits
      bare verbs, so ids collide across OpenTravel resource contracts.
- target: $.paths['/HospitalityRetrieveFacilityAvailability'].post
  update:
    tags:
    - Hospitality Facility
    description: Retrieve previously found hospitality facility availability.
    x-apievangelist-operation-id: RetrieveHospitalityAvailability
    x-apievangelist-operation-id-note: >-
      operationId `RetrieveHospitalityAvailability` is unique only within this document; the OTM compiler emits
      bare verbs, so ids collide across OpenTravel resource contracts.
- target: $.paths['/Facilities'].post
  update:
    tags:
    - Hospitality Facility
    description: Search hospitality facilities.
    x-apievangelist-operation-id: HospitalityFacilitySearch
    x-apievangelist-operation-id-note: >-
      operationId `HospitalityFacilitySearch` is unique only within this document; the OTM compiler emits
      bare verbs, so ids collide across OpenTravel resource contracts.