API Evangelist overlay for Evergreen Track & Trace API

overlay: 1.0.0
info:
  title: API Evangelist overlay for Evergreen Track & Trace API
  version: 1.0.0
extends: ../openapi/_original/evergreen-marine-track-and-trace-openapi.yml
x-generated: '2026-10-18'
x-method: generated
x-source: openapi/evergreen-marine-track-and-trace-openapi.yml
x-rationale: The captured spec has no security scheme, no servers and no externalDocs. Evergreen documents JWT access
  via Client ID & secret in its API portal FAQ. Server base URLs and the token URL are not published, so none are
  added. The original spec is not changed.
actions:
- target: $.info
  description: Point to the provider documentation page and record access model.
  update:
    x-provider: Evergreen Marine Corp. (ShipmentLink API Developer Portal)
    x-api-evangelist-aid: evergreen-marine:track-and-trace
    x-access: Registration required via https://www.shipmentlink.com/_ec/APIPORTAL_Register; Evergreen issues a
      Client ID and secret used to obtain a JWT (per https://www.shipmentlink.com/_ec/APIPORTAL_FAQ).
- target: $
  description: Add externalDocs pointing at the ShipmentLink API portal spec page.
  update:
    externalDocs:
      description: Evergreen Track & Trace API on the ShipmentLink API Developer Portal
      url: https://www.shipmentlink.com/_ec/APIPORTAL_SpecTrackAndTrace
- target: $
  description: Add the documented JWT bearer token as an apiKey Authorization header (Swagger 2.0 has no http bearer
    type).
  update:
    securityDefinitions:
      evergreenJWT:
        type: apiKey
        in: header
        name: Authorization
        description: Bearer JWT obtained from Evergreen JWT Service with the Client ID & secret issued at registration.
          Token URL is supplied per client in the service confirmation and is not published.
    security:
    - evergreenJWT: []