Stats API Question

[uyaem]

Hi all,

I couldn't really find an appropriate sub-forum in the "stats and servers" section, so I'm asking here:

The official stats pages seem to update slowly/cyclically, so I wanted to build a locally running web page that uses RESTful requests to get my user/team data, but I'm getting CORS errors.
Therefore, my question is:

Code: Select all

Is https://api.foldingathome.org considered public API?

(had to post as code block, or else the forum wouldn't let me post)

[Jesse_V]

Hi and welcome to the forum!

Yes, I believe that it is. There are a couple of tools that update stats for teams and users and I believe they download the flat stats file and parse it themselves. That way they have all the information at once and there's only one query. That's one option.

[bruce]

This forum is full of questions and answers and we haven't had time to write everything up as a (new?) FAQ.

Please do not try to query the stats in a home-made script. Our servers are all overcommitted, including the stats subsysem and you would be adding traffic to an already clogged path.

Today I've heard the stats system is (at least partially) broken and not being updated in real time. That DOES NOT imply that the available work assignments are not being processed or that the individual stats reports are not being recorded and cached. FAH has a very good record of preventing the loss of those records but some time may pass before the database is updated. Delayed stats are not missing stats.

Moreover, it's more important that all hands concentrate on getting enough servers on-line and filling them with work that can be assigned than providing real-time stats to people who are just checking how they're doing. Like the phone-mail recoding says ... Your call is important to us. All our staff are helping other customers and we'll respond as soon as we can. Please call back at a later time."

[uyaem]

I certainly didn't want to do bulk queries for that very reason.
And for that kind of "data mining" you're already providing the flat stat files I believe...

Regarding the stats not updating:
There seem to be several stats-providing end-points
- stats.foldingathomeorg/api (which is used by stats.foldingathome.org) seems to be behind
- api.foldingathome.org seems very up to date and working all the time, which is why I asked.

But thanks for the clarification, I won't cause any extra server load/traffic.