Browseable api does not have "games" endpoint?

[www.may69.com]

Hello, the browseable api does not have a games endpoint even though the apiary docs suggest that there is one.

[Lys]

Hi there!
Welcome to the club.

Browseable API... really?

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” https://ogs.docs.apiary.io/#reference/tournaments but I know, after some test an…

If you want information about Api, better search in the forum. If you don’t find your answer, then ask in the forum.

[benjito]

Note: you can get data from games/%game_id% (I realize that probably doesn’t help that much)

[GreenAsJade]

Yeah, the documentation there has the wrong idea, although the example response is correct.

The example response shows the details about a single game, and the correct route includes the game number (as benjito said):

https://online-go.com/api/v1/games/3217

Note that there’s no way an API is going to serve you all games in one request (There’s rather a lot of them).

[benjito]

@GreenAsJade

Note that there’s no way an API is going to serve you all games in one request (There’s rather a lot of them).

One might reasonably expect a paginated response, like players/ or tournaments/ though

[GreenAsJade]

Yes, I went looking for that, and for some reason that’s only available over the comm socket.

I think we have to conclude that /games once did work, but got turned off due to the load it would cause.

[benjito]

Yep. Too tempting to try and download the whole database plus I assume the fancy indexing that most of those endpoints support gets expensive

One solution/feature request is to publish aggregated games via torrent, so that load on official servers is minimized. (idea shamelessly stolen from that one chess site I always steal ideas from)