API Versioning in Rails Without Breaking Mobile and Partners
1 min read
Breaking JSON for mobile or B2B partners is expensive. Versioning is how you ship without a support fire drill.
I compare URL vs header versioning, how we document sunsets, and the contract tests that catch accidental field changes.
What you'll learn
- Picking one style per surface and sticking to it
- Deprecation headers and realistic sunset windows
- Shipping v2 while v1 still pays the bills
Next steps
Treat your OpenAPI or JSON schema as part of CI—not a PDF in a folder.