Experiment
API Drift Detective
Detecting change and drift between API versions - including in AI-powered APIs.
An API change detection platform focused on comparing API / schema versions and surfacing the differences that matter. The work explores schema comparison, change detection, and SignalR-driven feedback, with AI-assisted interpretation as an area of exploration.
- Status
- In ProgressExperiment
- Timeline
- Jan 2024 → …
- Signals
- API comparisonSchema diff.NETReactTypeScriptSignalR
Setting
Context
APIs change. Versions drift. For consumers - internal or external - the question is not 'did the API change', it is 'what changed, and does it matter for me?'.
This experiment focuses on API / schema comparison and change detection: given two versions of an API, what is different, and how do you present that difference in a way that is actually useful?
Motivations
What I wanted to explore
- Practical API / schema comparison: surfacing meaningful changes, not just textual diffs.
- Change detection as a first-class product surface rather than a side effect of a CI script.
- Using SignalR to push change events to a UI in real time.
- Where AI fits naturally into API change reporting, and where it does not.
Work in progress
Project scope
- An API change detection platform that compares API / schema versions.
- A UI to inspect the diff and understand the impact of changes.
- SignalR for live push of detected changes to connected clients.
- AI-assisted interpretation of detected changes as an area of exploration.
How it is built
Technical approach
The backend does the comparison work - fetching API specs, computing the diff, and publishing change events. The frontend consumes those events and presents the diff in a readable form.
- .NET backend for comparison and change detection.
- React + TypeScript frontend for the inspection experience.
- SignalR for pushing change events to the UI.
- AI exploration layered on top of detected changes where it adds value.
Notes from the build
What I learned
- API comparison is easy to start and surprisingly hard to make genuinely useful - context is everything.
- Live push of change events changes the UX in ways a polling approach cannot.
- AI is a tool, not a strategy: it helps where the underlying diff is already solid.
- Change detection is most valuable when it tells a story about impact, not just about lines.
Where this is now
Current status / next steps
Active build. The next areas of focus are tightening the comparison engine, expanding the inspection UI, and evaluating where AI-assisted interpretation adds the most value.
