Jeff - DEV Community

Jeff

Oct 5

Stop letting examples lie: make your OpenAPI spec the single source of truth for docs, mocks, and agents

#openapi #documentation #testing #webdev

4 min read

Jeff

Oct 5

REST API versioning in 2026: paths vs headers, additive changes, and OpenAPI diffs in CI

#api #versioning #openapi #webdev

2

4 min read

Jeff

Oct 5

Document API authentication in OpenAPI 3.1: Bearer, API keys, OAuth 2, and mTLS without the usual mistakes

#openapi #security #authentication #api

4 min read

Jeff

Oct 5

Reusable JSON Schema components in OpenAPI: DRY models without $ref spaghetti

#openapi #jsonschema #api #architecture

4 min read

Jeff

Oct 5

AST vs AI for reverse-engineering OpenAPI: where static analysis stops and the model earns its place

#openapi #ai #tooling #architecture

5 min read

Jeff

Oct 5

Generate OpenAPI from FastAPI and Django REST without decorating every view

#openapi #python #fastapi #django

4 min read

Jeff

Oct 5

Generate OpenAPI from Express and NestJS code without writing annotations by hand

#openapi #node #typescript #express

2

5 min read

Jeff

Oct 5

Bridge an existing HTTP API to A2A agents: JSON-RPC, REST, and gRPC from one handler

#a2a #api #architecture #node

5 min read

Jeff

Oct 5

The A2A Agent Card explained: discovery, supported interfaces, and signature verification

#a2a #security #ai #api

5 min read

Jeff

Oct 5

A2A vs MCP in 2026: when agents should talk to agents instead of calling tools

#a2a #mcp #ai #architecture

5 min read

Jeff

Oct 3

LLM Structured Outputs and JSON Schema: Tool Calling That Never Drifts

#llm #jsonschema #ai #openapi

2

5 min read

Jeff

Oct 3

One MCP Gateway for All Your Internal APIs: The Aggregation Pattern

#mcp #api #architecture #ai

5 min read

Jeff

Oct 3

MCP Security in Practice: Prompt Injection, Least Privilege, and Audit Logs

#mcp #security #ai #llm

1

2

5 min read

Jeff

Oct 3

MCP Tools vs Resources vs Prompts: What to Expose to an AI Agent

#mcp #ai #llm #api

4 min read

Jeff

Oct 3

Versioning MCP Tools Without Breaking the Agents That Call Them

#mcp #api #versioning #ai

4 min read

Jeff

Oct 3

MCP Clients Compared: Claude Desktop, Cursor, VS Code, Windsurf, Cline, and Zed

#mcp #ai #tooling #programming

4 min read

Jeff

Oct 3

Designing APIs for AI Agents: Idempotency, Machine-Readable Errors, and 202 + Webhooks

#api #ai #rest #architecture

5 min read

Jeff

Oct 3

How to Test and Debug an MCP Server: From the Inspector to Automated Tool Tests

#mcp #testing #debugging #ai

5 min read

Jeff

Oct 3

MCP stdio vs Remote Transports: Run It Locally or Host It?

#mcp #ai #architecture #api

2

5 min read

Jeff

Oct 3

MCP Authentication Explained: OAuth 2.1 for Remote MCP Servers

#mcp #oauth #security #ai

5 min read

Jeff

Oct 3

Connect Cursor and Claude Code to your internal API over MCP (step by step)

#ai #mcp #programming #tooling

5 min read

Jeff

Oct 3

MCP vs function calling vs ChatGPT plugins: what API teams actually need in 2026

#ai #mcp #api #architecture

5 min read

Jeff

Oct 3

API contract testing without Pact's overhead: a lighter workflow for small teams

#testing #api #qa #programming

4 min read

Jeff

Oct 3

Detect breaking API changes in CI with OpenAPI diffs (before your customers do)

#ci #api #openapi #programming

5 min read

Jeff

Oct 3

Generate a TypeScript client from OpenAPI: openapi-typescript vs openapi-generator vs openapi-fetch

#typescript #openapi #api #webdev

5 min read

Jeff

Oct 3

Mocking APIs for frontend development: MSW vs Prism vs spec-driven mocks

#webdev #react #testing #api

5 min read

Jeff

Oct 3

How to document webhooks in OpenAPI 3.1 (with signatures, retries, and examples)

#webdev #api #openapi #programming

4 min read

Jeff

Oct 3

How to test WebSocket APIs: handshakes, auth, reconnection, and repeatable scenarios

#websocket #api #testing #programming

5 min read

Jeff

Oct 3

How to test Server-Sent Events endpoints: curl, Postman, and spec-driven SSE testing

#api #testing #webdev #programming

4 min read

Jeff

Oct 3

REST error responses in 2026: RFC 9457 Problem Details vs the envelope you invented

#api #webdev #programming #architecture

4 min read

Jeff

Oct 3

Cursor vs offset pagination: what to actually put in your OpenAPI spec

#api #webdev #programming #architecture

4 min read

Jeff

Oct 3

How to organize a large OpenAPI spec: multi-file structure, $ref rules, and CI checks

#openapi #api #architecture #programming

2

5 min read

Jeff

Oct 3

Swagger 2.0 to OpenAPI 3.x migration: a field-tested checklist

#openapi #api #programming #webdev

5 min read

Jeff

Oct 3

Stoplight Studio is gone: five OpenAPI editors compared for 2026

#api #tooling #opensource #webdev

5 min read

Jeff

Oct 3

API-first vs code-first in 2026: the decision changed once AI agents joined the team

#api #architecture #ai #programming

5 min read

Jeff

Oct 3

Publish API docs and an MCP endpoint from one spec with a custom domain

#webdev #productivity #api #mcp

5 min read

Jeff

Oct 3

A local-first Postman alternative in 2026: what an OpenAPI-native workflow looks like

#webdev #api #tooling #programming

4 min read

Jeff

Oct 3

Stop pasting API docs into AI coding agents: serve the spec over MCP

#ai #mcp #api #programming

2

4 min read

Jeff

Oct 3

Convert curl commands and Postman collections into OpenAPI (without losing fields)

#api #postman #openapi #programming

4 min read

Jeff

Oct 3

OpenAPI 3.2 in 2026: what changed, and why it matters for SSE and AI agents

#openapi #api #architecture #webdev

4 min read

Jeff

Oct 3

Generate OpenAPI 3.2 from existing code: Express, FastAPI, Go, and Spring compared

#openapi #api #programming #opensource

4 min read

Jeff

Oct 3

Scenario testing for REST APIs: writing user-journey tests from OpenAPI

#testing #api #qa #webdev

2

4 min read

Jeff

Oct 3

The best OpenAPI mock servers in 2026: four tools tested on one real spec

#api #testing #webdev #programming

5 min read

Jeff

Oct 3

How to build beautiful, modern API documentation from OpenAPI in 2026

#api #documentation #webdev #opensource

5 min read

Jeff

Oct 3

How to turn an OpenAPI spec into an MCP server (2026 step-by-step)

#mcp #api #openapi #ai

5 min read

Jeff

Oct 3

Day 7: From a local spec to hosted docs and an MCP endpoint in an afternoon

#webdev #productivity #api #mcp

4 min read

Jeff

Oct 3

Day 6: I connected my coding agent to the API spec over MCP

#ai #mcp #api #programming

4 min read

Jeff

Oct 3

Day 5: We scanned a 200-route codebase into OpenAPI without uploading a file

#opensource #api #openapi #programming

1

5 min read

Jeff

Oct 3

Day 4: A 200 is not done — write API tests like a user walks the product

#testing #api #qa #webdev

4 min read

Jeff

Oct 3

Day 3: I stopped hand-rolling mock JSON and unblocked three teams

#webdev #api #testing #programming

2

4 min read

Jeff

Oct 3

Day 2: Designing an API with AI before the first line of code

#api #ai #tutorial #architecture

4 min read

Jeff

Oct 3

Your API spec is the prompt: stop re-explaining your backend to every AI

#api #openapi #ai #webdev

4 min read

Writing Debut

Want to connect with Jeff?