|Giuseppe Guerra 34f24b8de6 Add Bancho privilege||7 months ago|
|app||8 months ago|
|beatmapget||3 years ago|
|common||7 months ago|
|limit||3 years ago|
|vendor||2 years ago|
|.gitignore||3 years ago|
|LICENSE||3 years ago|
|README.md||1 year ago|
|main.go||2 years ago|
|startuato_linux.go||3 years ago|
|startuato_windows.go||3 years ago|
This is the source code for Ripple’s API.
The API is crammed with terrible design. First of all, it is not RESTful, and as you’ll come to learn, designing an API in a RESTful manner is good because it helps to create consistent design (across your API and other APIs). It also quite simplifies many other things:
/users?id=1009. It’s much more useful to have these in the URL path directly (
/users/1009) for a number of reasons:
/users/scores?id=1009will require a check to see if an ID is present.
/users/:id/scoresdoesn’t really need a check, because
codeparameter), so the user can likely reuse other parts for error handling that they already use for other http requests.
The not-making-it-RESTful was the biggest sin of the API. In itself, the API was a step into the right direction (it is MUCH better than the official osu! API), but nowhere close to how an API actually is, ideally. If you are building an API, I won’t recommend you a book, but instead I will recommend you to see what GitHub does, as they will have probably faced most problems that you have, and provided an answer already. If you’re unsure, check other APIs: Discord, Slack, Twitter, Stripe, to name a few.