My Envul Account

Envul Server List API

You need Developer API Key to use the Envul API. Please generate one from this page.

Envul Server List API Calls

All of the API Calls for the server list should be sent to api.envul.com

Here is an example of the 'Top Voters', in HTML Format:
https://api.envul.com/vote?dev_key=test&api_key=test&format=html&month=current&call=3


Check if user has voted

This function is used to check if a user has voted for the server within the last 24 hours.

Request Type: GET
vote?dev_key={your_dev_key}&api_key={server_API_key}&steamid={user_steam_id}&call=1
Parameter Description Data Type Required
dev_key Your Envul Developer API Key String Yes
api_key The Server's Listing API Key String Yes
steam_id The Steam ID of the user Integer Yes
format How the results will be returned to you String (html, csv, json) Yes
call Identifies the API Call to Envul Integer Yes
API Call Result Description
Error Code: 0 No vote found within 24 hours
Error Code: 1 The user has voted, but has not been rewarded for the vote.
Error Code: 2 The user has voted, and has been rewarded for the vote.
Incomplete Request Invalid parameters were provided to the API.
Invalid Server Listing API Key The provided api_key was not valid.
Invalid Developer API Key The provided dev_key was not valid.

Mark Vote as 'Rewarded'

This function is used to mark the vote as 'rewarded'. This can only be done for votes placed within 24 hours.

Request Type: GET
vote?dev_key={your_dev_key}&api_key={server_API_key}&steamid={user_steam_id}&call=2
Parameter Description Data Type Required
Developer API Key Your Envul Developer API Key String Yes
api_key The Server's Listing API Key String Yes
steam_id The Steam ID of the user Integer Yes
call Identifies the API Call to Envul Integer Yes
API Call Result Description
Error Code: 0 No vote found within 24 hours
Error Code: 1 The vote has been updated.
Error Code: 2 The vote has already been claimed.
Error Code: 3 Server 503 error. Please try in a short time.
Incomplete Request Invalid parameters were provided to the API.
Invalid Server Listing API Key The provided api_key was not valid.
Invalid Developer API Key The provided dev_key was not valid.

Display List of Top Voters

This function is used to display a list of top voters.

URL Request Data
vote?dev_key={your_dev_key}&api_key={server_API_key}&format={xml|json|html}&month{current|previous}&call=3
Parameter Description Data Type Required
Developer API Key Your Envul Developer API Key String Yes
api_key The Server's Listing API Key String Yes
month 'current' or 'previous' String Yes
format How the results will be returned to you String (html, csv, json) Yes
call Identifies the API Call to Envul Integer Yes
API Call Result Description
Error Code: 0 No votes found within the selected date range
Incomplete Request Invalid parameters were provided to the API.
Invalid Server Listing API Key The provided api_key was not valid.
Invalid Developer API Key The provided dev_key was not valid.