Information API [wiki.qeng.org]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
{{indexmenu_n>40}}
===== Information API =====
Domains have an information API with which you can retrieve information about all active and upcoming games on the domain in JSON format. This is useful for developing third-party services that duplicate domain information to other places (Telegram, websites, etc.).

==== Entry Point ====
**api_games_list.php**

**The GET parameter `json=1` must be added to the request. In this case, the response will be returned in JSON format.**

Example request:
[[https://game.qeng.org/api_games_list.php?json=1]]

==== Result Format ====
<code JavaScript>
[{Game}, {Game}, ...]
</code>
Here Game is an object of the following type:
<code JavaScript>
{
        "id": "3287",
        /* Game ID */
        "start_time": "2022-07-25 15:00:00",
        /* Game start time in human-readable format */
        "end_time": "2022-07-27 15:00:00",
        /* Game end time in human-readable format */
        "start_time_f": "1658750400",
        /* Game start time in unixtime format */
        "end_time_f": "1658923200",
        /* Game end time in unixtime format */
        "name": "QD10: Operation bolt or other adventures of gadget",
        /* Game name. Special characters in HTML entity format, e.g. &quot; */
        "type": "1",
        /* Winner is determined by:
        "0": Points
        "1": Time
        */
        "kind": "1",
        /* Game type:
        "0": other
        "1": green
        "2": yellow
        "3": red
        "4": virtual
        */
        "single": "0",
        /* Single-player or team game:
        "0": Team game
        "1": Single-player game
        */
        "description": "PS: follow updates.&lt;\/strong&gt;&lt;\/p&gt;\r\n",
         /* Game description */
        "authors": [
            /* List of authors */
            {
                "uid": "2130",
                /* Player ID */
                "username": "StelZ"
                /* Player username */
            }
        ],
        "teams": [
            /* List of teams that submitted requests for the game. For single-player games - list of players who submitted requests */
            {
                "id": "201",
                /* Team ID */
                "name": "911 Team",
                /* Team name */
                "status": "0"
                /* Request status:
                "0": Applied
                "1": Accepted into the game
                "2": Accepted for test
                */
            },
            {
                "id": "200",
                "name": "Nostra sQuadra",
                "status": "0"
            },
        ]
    }
}
</code>

===== Information Telegram Bot =====
You can also receive information about updates on the website using the [[en:info_api:tg_bot|Information Telegram bot]].