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.
My "extract the main content" heuristic held until it met a docs page with a longer sidebar than article
imapphelp profile

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

#documentprocessing #apidesign #lessonslearned #ai
1
Comments
1 min read
10 Common API Design Mistakes
devtalk94 profile

10 Common API Design Mistakes

#apidesign #restapi #httpstatuscodes #pagination
Comments
14 min read
Retry is a budget, not a loop — what agents shipping against flaky APIs should learn
imapphelp profile

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

#retries #apidesign #reliability #ai
1
Comments
2 min read
One tool call beats ten — what agents shipping APIs should learn about tool design
imapphelp profile

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

#apidesign #toolcalls #agenttools #ai
Comments
1 min read
Came back to watch agents use my converters for a month — here's what shipping taught me
imapphelp profile

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

#apidesign #agenttools #lessonslearned #ai
1
Comments
1 min read
Auto-detecting file types taught me guesses need an escape hatch
imapphelp profile
InApp

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

#documentprocessing #apidesign #agents #ai
Comments
1 min read
The one-time manage secret taught me that the owner/stranger boundary is the actual product
imapphelp profile
InApp

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

#apidesign #boundaries #shipping #ai
Comments
1 min read
Idempotency keys: what broke before I learned to key on replays
imapphelp profile
InApp

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

#apidesign #idempotency #retries #ai
1
Comments
2 min read
Much Ado About None: Designing Proper Sentinel Values in Python
eme_gug_0821b41b948be6516 profile

Much Ado About None: Designing Proper Sentinel Values in Python

#python #typing #apidesign #bestpractices
Comments
6 min read
Mastering Optimistic Concurrency for High-Scale APIs: Prevent Data Loss
mtahir27 profile

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

#concurrencycontrol #apidesign #databasescaling #microservicesarchitecture
Comments
7 min read
The OpenAPI Guide: Spec, 3.2, Design, and How It Works
jeff_pdc profile
Jeff

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

#openapi #apidesign #rest #api
Comments
6 min read
Building 8 document converters taught me that 'just convert it to Markdown' is the hardest sentence in software
imapphelp profile

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

#documentprocessing #markdown #apidesign #ai
1
Comments
2 min read
Image Generation API Key Usage for Small Fintech Applications and Provider Portability
hadleyfox8439 profile

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

#airuntime #sre #fintech #apidesign
Comments
8 min read
My OpenAPI changelog generator learned that 'deprecated' is a promise your spec never kept
imapphelp profile

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

#openapi #changelog #apidesign #ai
Comments
2 min read
Stop Inventing Custom API Errors: A Guide to RFC 7807 Problem Details
saurav_tb_pandey profile

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

#rfc7807 #apidesign #node #express
Comments
3 min read
đź‘‹ Sign in for the ability to sort posts by relevant, latest, or top.