tdwg / apis

Application programming interfaces (services and clients) for biodiversity information
9 stars 0 forks source link

Put an explicit version name in the path #18

Open DavidFichtmueller opened 2 years ago

DavidFichtmueller commented 2 years ago

Put an explicit version name in the path /v1/ and commit to & share the timeline of guaranteed backward compatibility

ianengelbrecht commented 2 years ago

This needs consideration. One of the desirable features of PIDs is that they should provide a human readable web page for Accept:text/html requests, and machine readable data for Accept:application/json requests, from the same URL. So we might not want to include ‘api’ or version numbers in our URLs after all.