Jeff - DEV Community

Jeff

Oct 8

Validate HTTP requests and responses against OpenAPI at runtime: middleware, proxies, and fail-open vs fail-closed

#openapi #api #webdev #programming

6 min read

Jeff

Oct 8

A2A streaming and the task lifecycle: SSE progress updates, artifacts, and push notifications

#ai #agents #a2a #webdev

6 min read

Jeff

Oct 8

Multiple security schemes in OpenAPI: AND vs OR, optional auth, and per-operation overrides

#openapi #security #api #webdev

5 min read

Jeff

Oct 8

Health checks for APIs: /healthz, /readyz, /livez, version, and metrics in OpenAPI

#api #kubernetes #devops #webdev

5 min read

Jeff

Oct 8

OpenAPI docs renderers compared: Swagger UI, Redoc, Scalar, Stoplight Elements, and RapiDoc on one spec

#openapi #api #documentation #webdev

6 min read

Jeff

Oct 8

Enforce an API style guide in CI with Spectral: custom rules that stop bad OpenAPI before it merges

#openapi #api #webdev #programming

5 min read

Jeff

Oct 8

OpenAPI servers and server variables: local, staging, production, regions, and per-tenant hosts from one spec

#openapi #api #webdev #tutorial

5 min read

Jeff

Oct 8

operationId and tags in OpenAPI: naming conventions that keep generated SDKs and docs usable

#openapi #api #codegen #programming

5 min read

Jeff

Oct 8

Deprecating an API without breaking clients: Deprecation and Sunset headers, successor-version, and OpenAPI

#api #webdev #architecture #programming

5 min read

Jeff

Oct 8

File downloads in OpenAPI: CSV, PDF, ZIP, images, Content-Disposition, and non-JSON responses

#openapi #api #webdev #tutorial

5 min read

Jeff

Oct 8

Designing a search endpoint in OpenAPI: q, filters, sorting, sparse fieldsets, and pagination codegen understands

#openapi #api #webdev #programming

5 min read

Jeff

Oct 8

Long-running REST APIs: 202 Accepted, Location, job status polling, and webhooks in OpenAPI

#api #webdev #architecture #programming

5 min read

Jeff

Oct 8

Bulk and batch API endpoints: modeling create-many, partial success, and 207 Multi-Status in OpenAPI

#openapi #api #webdev #architecture

5 min read

Jeff

Oct 8

Idempotency-Key in practice: retrying POSTs safely, deduping concurrent requests, and documenting it in OpenAPI

#api #webdev #architecture #programming

5 min read

Jeff

Oct 8

Dates, times, and time zones in OpenAPI: date-time, date, duration, and the timezone mistakes that shift bookings

#openapi #api #webdev #tutorial

5 min read

Jeff

Oct 8

Modeling money and big integers in OpenAPI: int64 precision, decimal amounts, and why number fails for currency

#openapi #api #webdev #programming

5 min read

Jeff

Oct 8

readOnly and writeOnly in OpenAPI: one schema for create, response, and password fields

#openapi #api #typescript #webdev

5 min read

Jeff

Oct 8

OpenAPI additionalProperties: modeling maps, dictionaries, labels, and free-form objects without losing types

#openapi #api #typescript #webdev

5 min read

Jeff

Oct 8

Recursive and cyclic schemas in OpenAPI: self-referencing $ref for trees, nested comments, and graphs

#openapi #api #webdev #tutorial

5 min read

Jeff

Oct 8

OpenAPI enums vs const: closed lists, open-ended strings, and how to add a value without breaking clients

#openapi #api #webdev #programming

5 min read

Jeff

Oct 7

Optional, nullable, or omitted? Modeling missing data in OpenAPI 3.1 without lying to clients

#openapi #jsonschema #api #webdev

5 min read

Jeff

Oct 7

PUT vs JSON Merge Patch vs JSON Patch: modeling partial updates in OpenAPI without the null ambiguity

#openapi #api #webdev #programming

5 min read

Jeff

Oct 7

OpenAPI callbacks vs webhooks: modeling async request/reply with runtime expressions

#openapi #api #webdev #architecture

5 min read

Jeff

Oct 7

The JSON Schema constraints that actually work in OpenAPI: format, pattern, ranges, and what codegen and AI mocks do with them

#openapi #jsonschema #codegen #api

5 min read

Jeff

Oct 7

Model polymorphism in OpenAPI 3.1: oneOf, anyOf, allOf, and discriminator without breaking clients

#openapi #jsonschema #typescript #api

4 min read

Jeff

Oct 7

Document rate limits in OpenAPI so clients actually back off: 429, Retry-After, and rate-limit headers

#openapi #api #webdev #tutorial

5 min read

Jeff

Oct 7

Prevent lost updates with ETag and If-Match: optimistic concurrency in OpenAPI

#openapi #api #webdev #architecture

4 min read

Jeff

Oct 7

File uploads in OpenAPI: multipart/form-data, raw binary, and multiple files done right

#openapi #api #webdev #tutorial

5 min read

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

3

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

1

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

1

4 min read

Jeff

Oct 3

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

#mcp #ai #tooling #programming

1

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

Writing Debut

Want to connect with Jeff?