Hometrack · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Hometrack Valuation API

3 actions 3 updates update extends openapi/hometrack-valuation-api-v1-openapi.yml
Authorship not recorded No authorship marker is recorded for this file. It is not presented as the provider's.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-providerx-apievangelist-generatedx-apievangelist-sourcex-apievangelist-operationsx-apievangelist-accessx-apievangelist-notesOAuth2ClientCredentialsx-apievangelist-server-note

Targets 3

$.info
$.components.securitySchemes
$.servers

OpenAPI Overlay

Raw ↑
overlay: 1.0.0
info:
  title: API Evangelist enhancements for Hometrack Valuation API
  version: 1.0.0
extends: openapi/hometrack-valuation-api-v1-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-provider: hometrack
    x-apievangelist-generated: '2026-07-26'
    x-apievangelist-source: https://developer.hometrack.com/apis (Azure API Management OpenAPI export)
    x-apievangelist-operations: 3
    x-apievangelist-access:
      pricing: paid
      onboarding: partner
      public: false
      trial: false
      note: Contracts are public; the data plane returns HTTP 401 without a Hometrack-issued credential.
    x-apievangelist-notes: 'GET /status is the only anonymously reachable operation in Hometrack''s published
      surface (HTTP 200, zero-byte body, probed 2026-07-26). The token returned by POST /authentication/{apiKey}
      is valid for 5 minutes and is presented as Authorization: Token token="<guid>".'
- target: $.components.securitySchemes
  update:
    OAuth2ClientCredentials:
      type: oauth2
      description: Documented on https://developer.hometrack.com/api-authentication but absent from the
        Azure API Management export. Added here as an overlay, not a change to the harvested spec.
      flows:
        clientCredentials:
          tokenUrl: https://hometrack-prod.eu.auth0.com/oauth/token
          scopes:
            read:valuations: Read access to valuations.
            write:valuations: Write access to valuations.
- target: $.servers
  update:
    x-apievangelist-server-note: The second declared server, api.hometrack.local, is an internal development
      hostname that does not resolve publicly. Only https://api.hometrack.com is usable.