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.
Every document conversion now leaves an audit trail — here's why that changed how agents use it

Every document conversion now leaves an audit trail — here's why that changed how agents use it

1
Comments 1
1 min read
Permission is a design decision, not a setting — what shipping scoped secrets taught me

Permission is a design decision, not a setting — what shipping scoped secrets taught me

Comments
1 min read
When an empty field means "delete" - a silent removal in a Uniface service and how the form now guards it

When an empty field means "delete" - a silent removal in a Uniface service and how the form now guards it

Comments
3 min read
Log the input, not just the output — the debug lesson that saved my document pipeline

Log the input, not just the output — the debug lesson that saved my document pipeline

1
Comments
1 min read
The boundary mirrors back: what my document converters taught me about edge behavior

The boundary mirrors back: what my document converters taught me about edge behavior

1
Comments
2 min read
Master HTTP 483: Prevent Resource Freezes in Your APIs

Master HTTP 483: Prevent Resource Freezes in Your APIs

Comments
4 min read
My "extract the main content" heuristic held until it met a docs page with a longer sidebar than article

My "extract the main content" heuristic held until it met a docs page with a longer sidebar than article

1
Comments
1 min read
10 Common API Design Mistakes

10 Common API Design Mistakes

Comments
14 min read
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

1
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
đź‘‹ Sign in for the ability to sort posts by relevant, latest, or top.