Serkan
Should I move my API error bodies to the RFC 7807 problem+json format?
Standardize on RFC 9457 rather than 7807, produce every error body in one central exception handler, and manage the `type` URI as a versionable contract.
All questions
Tag
#API Design
Contracts, versioning and resource modelling: growing an API without breaking it. Questions under this tag, answered directly.
3 answered questions carry this tag.
Ece
Should I author the OpenAPI spec first or generate it from my code?
Go contract-first with `openapi.yaml` as the single source of truth; what ends drift isn't the direction you pick but a green contract test running in CI.
Burak
How should I run the sunset process when deprecating an endpoint in my public API?
Instrument usage per partner, publish a dated sunset with Sunset and Deprecation headers on every response, run brownouts, and cut when usage nears zero.