Make API operations findable.
A compact retrieval demo that reads OpenAPI specifications, indexes individual operations, and returns ranked matches for natural-language queries.
My focus: Operation-level indexing and a simple, inspectable retrieval baseline.
Result: A portable JSON index and local keyword search over dummy banking specifications. This public sample runs without a model or vector database.
Python · OpenAPI · YAML · JSON · pytest
Keep the result inspectable.
Show the operation and the words behind the match.
01 / ASK A QUESTION
How do I create a payment?
02 / INSPECT THE MATCH
/paymentsCreate a payment
- Operation ID
createPayment- Source
- Illustrative OpenAPI spec
The query and operation share the words “create” and “payment”.
SPEC → INDEX → QUERY → MATCH
Authored examples with dummy operations. Buttons switch between preset explanations; no search or banking API runs here.
Inside the retrieval decisions
An API specification contains many operations. A developer needs a relevant operation without reading the entire document.
Index individual operations and start with local keyword search. Keep the result portable and easy to inspect.
Keyword matches can miss synonyms and intent. This public sample is a retrieval baseline, separate from enterprise RAG work.


@a.viewer storm 🔥 need this