Hilt · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Hilt So Testing API

5 actions 5 updates phrasing extends openapi/hilt-so-testing-api-openapi.yml

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

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info

$.paths['/v1/testing/scenarios'].get

$.paths['/v1/testing/sessions'].get

$.paths['/v1/testing/sessions'].post

$.paths['/v1/testing/sessions/{session_id}'].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 Hilt So Testing API
  version: 1.0.0
extends: openapi/hilt-so-testing-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['/v1/testing/scenarios'].get
  update:
    x-apievangelist-phrasing:
      intent: List sandbox test scenarios
      effect: read
      questions:
      - What payment scenarios can I simulate in the sandbox?
      - Which test outcomes are supported for simulated sessions?
      instructions:
      - text: List the supported sandbox scenarios.
      - text: Show which scenarios I can simulate.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/testing/sessions'].get
  update:
    x-apievangelist-phrasing:
      intent: List recent simulated sessions
      effect: read
      questions:
      - Which sandbox sessions have I run recently?
      - Can I see my last few simulated payments?
      instructions:
      - text: List my recent simulated sessions.
      - text: Show the last {limit} sandbox sessions.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/testing/sessions'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a simulated sandbox session
      effect: write
      questions:
      - How do I simulate a payment scenario against one of my products?
      - Can I set a test amount and payer wallet for a simulation?
      instructions:
      - text: Simulate scenario {scenario}.
        slots:
          scenario: requestBody.scenario
      - text: Run scenario {scenario} on product {product_id} for {amount_minor_units}.
        slots:
          scenario: requestBody.scenario
          product_id: requestBody.product_id
          amount_minor_units: requestBody.amount_minor_units
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/testing/sessions/{session_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a simulated sandbox session
      effect: read
      questions:
      - What was the result of a specific simulated session?
      - Can I inspect one sandbox run in detail?
      instructions:
      - text: Show simulated session {session_id}.
        slots:
          session_id: path.session_id
      - text: Get the outcome of sandbox run {session_id}.
        slots:
          session_id: path.session_id
      method: generated
      generated: '2026-09-26'