tdc2016poa | trilha arquitetura - versioning apis
TRANSCRIPT
Why do I care?
● Distributed components● Isolation● Microservices evolving independently● Deploy anytime
Version as path/query parameter
https://host/api/v1/bands/1/albuns https://host/api/bands/albuns?version=1 ● Explicit
● Cleaner for consumers● Harder to identify● Intrusive
Version as a header
Accept: application/json; version=1.0
● Less intrusive● Does not polute URL● Easier to identify● No specification for that
or use a custom header
Take care of your contracts
● It’s your front door● Care about your design● Discuss contract changes, do it cautiously● Postpone decisions● Test your contracts
Thanks
Marcelo Cure - Software Engineer at ilegra
Twitter: @__cure
http://marcelo-cure.blogspot.com.br