Comments (2)
I thought about this, but I ended up deciding that it just looks friendlier without the version number there, for now. If I make it to 2.0, and anyone at all is using this thing, then I might do something like /api2/
.
from corpus-db.
OK. Only issue is that if I, or someone else, makes a script using this version, and then you update it, you're stuck either keeping all the endpoints the same or breaking the scripts. As an API designer you're making an implicit contract with the user, if you change stuff then people will be hesitant to build anything with it.
You might consider supporting an optional query parameter that allows the old version. Alternatively you could call all of this a beta and just say it's not ready for prime time yet. Since you have to support old versions once you have them that might be the way to go. But I do feel like an API is not like a website, if people are building stuff then you have to trust that stuff won't break.
from corpus-db.
Related Issues (20)
- Parse Gutenberg RDF-XML straight from the source HOT 1
- Migrate to Docker HOT 1
- New API endpoint for Wikipedia categories
- Add more example analyses
- Make local test DB and add to GitHub repo
- Set up log file system and hook them up to fail2ban HOT 1
- Make favicon and get it serving correctly
- Max results query parametr HOT 3
- Semantic endpoints (singular/plural) HOT 1
- IDs formatted as floats HOT 4
- Full text wrapped in square brackets HOT 1
- Missing full texts for some books HOT 2
- More semantics
- Speed up full-text search response
- Need a title search
- Create documentation for new RISE endpoints
- Make better site design
- api returns a prefix of the json when requesting fulltext HOT 2
- Import Gutenberg metadata to Fuseki container 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 corpus-db.