3 ms·
Quick suggestion about the API endpoints, versioning is really important as it allows you to add/remove/update features without breaking any application using y
by iampims 16y ago
Quick suggestion about the API endpoints, versioning is really important as it allows you to add/remove/update features without breaking any application using your API. You should add it before anyone starts building on top of your API.
- generalk 16y agoVersioning should really be done with an "Accepts" HTTP header as opposed to changing a resource's URL. http://www.informit.com/articles/article.aspx?p=1566460 http://www.informit.com/articles/article.aspx?p=1566460
- iampims 16y agoIn a perfect world, I’d agree with you. The author of the article you linked to provides a good answer to this problem: If your audience is architecturally minded and aware of REST, you should version data representations in the MIME types your application accepts. If your clients view the URL as the most important facet, make the URL the center of your versioning efforts. Folks who are familiar with versioning with WS-* Web services tend to be more comfortable with changing the URL when versions change.
- tomzeng 16y agoBoth approaches should work, putting version in the url seemed to be more widely used, we will take both in to consideration, thanks for the suggestions