Files
OllaHub/.agent/skills/api-patterns/versioning.md
T
evandro 861af0bb9f
release.yml (push) Invalid workflow file
wip: snapshot das alterações não commitadas (2026-10-20)
Origem: D:/Documents/Github/OllaHub
Arquivos omitidos (segredos, bancos de dados, logs, >50 MB): 0
2026-10-20 00:49:46 -03:00

651 B

Versioning Strategies

Plan for API evolution from day one.

Decision Factors

Strategy Implementation Trade-offs
URI /v1/users Clear, easy caching
Header Accept-Version: 1 Cleaner URLs, harder discovery
Query ?version=1 Easy to add, messy
None Evolve carefully Best for internal, risky for public

Versioning Philosophy

Consider:
├── Public API? → Version in URI
├── Internal only? → May not need versioning
├── GraphQL? → Typically no versions (evolve schema)
├── tRPC? → Types enforce compatibility