API Documentation

Welcome to the M79 Climb API. Below are the available endpoints and how to use them.

Get X Map's Best Caps

Endpoint: GET /besttimes/{mapName}/{x}

Description: Retrieves the top X best times for a given map.

Ex.: https://m79climb.nequs.space/api/besttimes/m79_Hardplan/3

Ex. Response:

Player1 01:15:124 2025-02-19
Player2 02:30:853 2025-01-15
Player3 02:05:229 2025-01-11

Get X Player's Best Caps

Endpoint: GET /times/{playerIp}/{playerName}/{mapName}/{x}

Ex.: https://m79climb.nequs.space/api/times/Nequs/m79_Hardplan/5

Description: Retrieves top X times for a given map, filtered by player name or IP. If you dont know ip, put anything ex. 0

Ex. Response:

Player1 00:05:824 2025-02-19 01:12:12
Player1 00:05:824 2025-02-18 21:15:53
Player1 00:05:824 2025-01-11 22:32:53
Player1 00:05:824 2025-04-22 11:10:53
Player1 00:05:824 2025-01-01 05:45:53

Get Player Stats

Endpoint: GET /playerstats/{playerName}

Ex.: https://m79climb.nequs.space/api/playerstats/Nequs

Description: Retrieves the player stats such as grenades thrown, M79 shots fired, server visits, and respawns.

Ex. JSON Response:

[
  {
    "Name": "Nequs",
    "GrenadesThrown": 100,
    "M79ShotsFired": 250,
    "TimeSpentOnServer": "01:23:45",
    "ServerVisits": 5,
    "Respawns": 30
  }
]

Error Handling

In case of an error, the API returns an appropriate HTTP status code along with an error message.

Contact _nequs on Discord if you have any suggestions or problems!