Comments (2)
Is the mediator domain (m.ac.org) only going to run an API, or other interfaces as well (in which case, do we need /api
?
Versioning can be annoying. Some people recommend using subdirectories, some people recommend using headers: http://stackoverflow.com/a/6750376
I know you use v1
in freesound, but I've also used just a number.
In specific answer to your question, yes, I think we should including versioning from the beginning. I don't know which system we should use, though.
from ac-mediator.
The mediator will not only return api calls but also other interfaces, that's why we use /api/
.
I think v#
is better to just a number #
as in my opinion is more self-explanatory.
I don't like the idea of using a header as the information is a lot less explicit, also using sub-directories can be confusing as is clearly separating other mediator's interfaces from API.
Many well-known APIs add version in the url so I think this is a good way to go.
I'll add /api/v1/
for now and see how it works.
from ac-mediator.
Related Issues (20)
- Registration process extras HOT 1
- How to properly store service account credentials? HOT 1
- Deal with expired tokens HOT 3
- Make request distributor asynchronous HOT 1
- Use COPY for requirements.txt in Dockerfile
- Enable authentication to audio commons api
- Deal with old response objects in store HOT 1
- Remove http to https redirect in nginx container HOT 1
- Autogenerate ssl certificates for development HOT 1
- Monitor Redis and Celery state
- Adapt API client form
- Reload link services page after linking a service HOT 1
- Allow api clients recommend services to link
- Add "/me" API endpoint HOT 1
- Add support for JSON-LD format HOT 5
- Decouple acservice package and service integration tests from mediator
- OAuth token returns 401 when calling it without trailing slash HOT 1
- Add travis integration
- Add support for filtering in Search endpoint HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from ac-mediator.