Hi, sometimes I feel dumb. Here is one case.
I know that apiary (https://ogs.docs.apiary.io/#) is outdated and incomplete, though someway useful.
And I know that test queries can be done on the Django REST framework (https://online-go.com/api/). I used it many times.
What I miss is a list of all API branches.
Let’s take tournaments as an example.
Apiary contains just “List tournaments” and “Create tournament”
but I know, after some test and some post in the forum, that you can obtain also “tournament details” for a single tournament:
and also “tournament players”
and “tournament rounds”
The Django REST framework claims to be browseable and sometimes I find links in the result for some call. For example, “next” page in “tournament players”.
Sometimes there’s a “Related” field with some related URL (not links, just text). Just look at your personal data:
You can find many other branches listed at the end of the page.
Browsing and searching on the forum I found many times said that APIs are “browseable” but I don’t really understand what that means, since for me it should be something like a tree that you can explore, but it isn’t.
Maybe is something that could be, but isn’t implemented yet. The Django documentations actually talks about browseable APIs but it seems to me that it’s up to the devs to implement such links:
But still I doubt that I’m missing something and there’s some simple click that can show me what I’m looking for, but haven’t found yet. Is it so?