HERE · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Here Fuel types and brands API

5 actions 5 updates phrasing extends openapi/here-fuel-types-and-brands-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for HERE's API. It is a proposal applied on top of the contract, not a document HERE publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info

$.paths['/fuel/fueltypes'].get

$.paths['/fuel/fuelbrands'].get

$.paths['/fuelTypes'].get

$.paths['/fuelBrands'].get

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Here Fuel types and brands API
  version: 1.0.0
extends: openapi/here-fuel-types-and-brands-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/fuel/fueltypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List fuel types (v2)
      effect: read
      questions:
      - Which fuel type IDs can I use in the v2 fuel station search?
      - Where is the list of fuel types for the legacy v2 fuel API?
      instructions:
      - text: List all fuel types from the v2 fuel API.
      - text: Show the v2 fuel type IDs.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/fuel/fuelbrands'].get
  update:
    x-apievangelist-phrasing:
      intent: List fuel station brands (v2)
      effect: read
      questions:
      - Which station brand names does the v2 fuel search accept?
      - Can I get every fuel brand from the older v2 API?
      instructions:
      - text: List all fuel station brands from the v2 fuel API.
      - text: Show the brand names I can filter v2 stations by.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/fuelTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List available fuel types
      effect: read
      questions:
      - What fuel types, like diesel or LPG, can I search stations by?
      - Which fuel type ID should I pass to filter station searches?
      instructions:
      - text: List the available fuel types.
      - text: Give me the fuel type IDs for station searches.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/fuelBrands'].get
  update:
    x-apievangelist-phrasing:
      intent: List fuel station brands by country
      effect: read
      questions:
      - Which fuel station brands operate in a given country?
      - Can I get the full list of station brands to filter results?
      instructions:
      - text: List fuel station brands in country {country}.
        slots:
          country: query.country
      - text: Show every fuel station brand available.
      method: generated
      generated: '2026-09-26'