Apidesign - DEV Community

DEV Community

#apidesign

Best practices for designing, versioning, and managing robust REST and gRPC APIs.

Posts

đź‘‹ Sign in for the ability to sort posts by relevant, latest, or top.
Retry is a budget, not a loop — what agents shipping against flaky APIs should learn

Retry is a budget, not a loop — what agents shipping against flaky APIs should learn

Comments
2 min read
One tool call beats ten — what agents shipping APIs should learn about tool design

One tool call beats ten — what agents shipping APIs should learn about tool design

Comments
1 min read
Came back to watch agents use my converters for a month — here's what shipping taught me

Came back to watch agents use my converters for a month — here's what shipping taught me

1
Comments
1 min read
Auto-detecting file types taught me guesses need an escape hatch

Auto-detecting file types taught me guesses need an escape hatch

Comments
1 min read
The one-time manage secret taught me that the owner/stranger boundary is the actual product

The one-time manage secret taught me that the owner/stranger boundary is the actual product

Comments
1 min read
Idempotency keys: what broke before I learned to key on replays

Idempotency keys: what broke before I learned to key on replays

1
Comments
2 min read
Much Ado About None: Designing Proper Sentinel Values in Python

Much Ado About None: Designing Proper Sentinel Values in Python

Comments
6 min read
Mastering Optimistic Concurrency for High-Scale APIs: Prevent Data Loss

Mastering Optimistic Concurrency for High-Scale APIs: Prevent Data Loss

Comments
7 min read
The OpenAPI Guide: Spec, 3.2, Design, and How It Works

The OpenAPI Guide: Spec, 3.2, Design, and How It Works

Comments
6 min read
Building 8 document converters taught me that 'just convert it to Markdown' is the hardest sentence in software

Building 8 document converters taught me that 'just convert it to Markdown' is the hardest sentence in software

1
Comments
2 min read
Image Generation API Key Usage for Small Fintech Applications and Provider Portability

Image Generation API Key Usage for Small Fintech Applications and Provider Portability

Comments
8 min read
My OpenAPI changelog generator learned that 'deprecated' is a promise your spec never kept

My OpenAPI changelog generator learned that 'deprecated' is a promise your spec never kept

Comments
2 min read
Stop Inventing Custom API Errors: A Guide to RFC 7807 Problem Details

Stop Inventing Custom API Errors: A Guide to RFC 7807 Problem Details

Comments
3 min read
My short-link stats API taught me that 'permanent' links still need someone to remember them

My short-link stats API taught me that 'permanent' links still need someone to remember them

Comments 1
1 min read
Unified LLM API Fallback for Edtech Moderation — Cost and Retention Trade-offs

Unified LLM API Fallback for Edtech Moderation — Cost and Retention Trade-offs

Comments
6 min read
đź‘‹ Sign in for the ability to sort posts by relevant, latest, or top.