Raised This Month: $12 Target: $400
 3% 

[TF2] Unified Open API for looking up bans


Post New Thread Reply   
 
Thread Tools Display Modes
Author Message
Nikkii
Member
Join Date: Feb 2012
Old 03-04-2016 , 20:44   [TF2] Unified Open API for looking up bans
Reply With Quote #1

Often we'll have a few people on our servers that are fishy, but we can't pinpoint whether they're cheating or not. The best way to do this is to google their SteamID2 with "sourcebans" in the query. This gets you a list of servers where they appear in their SourceBans database for whatever reason.

After a while of doing this, it got tedious. I have aggregated the bans from 5 different communities (currently) - and put their results into a single API. Communities in this list will only be well-known and trustworthy, though the results should be taken with a grain of salt (bans could be for reasons other than cheating, and not for reasons you particularly agree with.) It reports expired bans, too, so take that into account when querying the API, as it should only be used as a guideline or resource to help with a ban decision.

The following URL accepts GET or POST, either with the steamid parameter in the query or body, as a Steam2, Steam3, or Community ID.

Code:
https://api.meow.tf/sourcebans/lookup?steamid=<steamid2/steamid3/steamid64>
Responses are as follows:

Empty:
Code:
{
    "query": "76561198046627751",
    "steamid": {
        "steam2": "STEAM_0:1:43181011",
        "steam3": "[U:1:86362023]",
        "community": "76561198046627751"
    },
    "time": 1457141370,
    "results": {
        "probablyaserver": [],
        "firepowered": [],
        "gaming-servers": [],
        "skial": [],
        "tf2app": []
    }
}
Results:
Code:
{
    "query": "STEAM_0:1:91821056",
    "steamid": {
        "steam2": "STEAM_0:1:91821056",
        "steam3": "[U:1:183642113]",
        "community": "76561198143907841"
    },
    "time": 1457142906,
    "results": {
        "probablyaserver": [
            {
                "authid": "STEAM_0:1:91821056",
                "name": "R4V3N",
                "reason": "Wallhack, Ping masking, Trigger bot",
                "created_at": 1456711708,
                "expires_at": null,
                "removed_at": null
            }
        ],
        "firepowered": [],
        "gaming-servers": [],
        "skial": [],
        "tf2app": [
            {
                "authid": "STEAM_0:1:91821056",
                "name": "Tai-Ni-Po-Ni",
                "reason": "Steam Community Group Ban (annoyingprogamers) LMAOBOX group",
                "created_at": 1432232820,
                "expires_at": null,
                "removed_at": null
            }
        ]
    }
}
It is rate limited to 30 unique lookups an hour. Subsequent lookups of the same id or cached lookups do not count towards this limit.

Special thanks to Dr. McKay and the communities whose SourceBans installations this uses. Is your community in this list, and you don't want it to be? Perhaps you want it added? Let me know via PM here, on GameSurge (Nick: Nikkii), or Steam.

Communities:
  • ProbablyAServer
  • FirePowered
  • Gaming-Servers.net
  • TF2APP
  • Skial
__________________
Owner of ProbablyAServer, a server without game changing mods and donation benefits

RCON Helper | [TF2] LogUpload | CCC Donator Tags | PHP Steam API Wrapper

Last edited by Nikkii; 03-05-2016 at 16:15.
Nikkii is offline
Dagothur
Member
Join Date: Dec 2014
Old 03-05-2016 , 08:45   Re: [TF2] Unified Open API for looking up bans
Reply With Quote #2

Neat. What response is returned when you reach the rate limit?


EDIT:

This guy isn't showing any hits:

https://api.meow.tf/sourcebans/looku..._0:0:119672057
https://www.skial.com/sourcebans/ind...ist&advSearch=[U:1:239344114]&advType=steamid&Submit

Last edited by Dagothur; 03-05-2016 at 08:50.
Dagothur is offline
Nikkii
Member
Join Date: Feb 2012
Old 03-05-2016 , 14:03   Re: [TF2] Unified Open API for looking up bans
Reply With Quote #3

Quote:
Originally Posted by Dagothur View Post
Neat. What response is returned when you reach the rate limit?


EDIT:

This guy isn't showing any hits:

https://api.meow.tf/sourcebans/looku..._0:0:119672057
https://www.skial.com/sourcebans/ind...ist&advSearch=[U:1:239344114]&advType=steamid&Submit
Rate limit is just an HTTP 429 response with the body "{"success":false, "error": "Too Many Attempts."}"

That's because they store their SteamIDs in the steam3 format I guess, thanks for pointing this out, I'll fix it up

Edit: All fixed.
__________________
Owner of ProbablyAServer, a server without game changing mods and donation benefits

RCON Helper | [TF2] LogUpload | CCC Donator Tags | PHP Steam API Wrapper

Last edited by Nikkii; 03-05-2016 at 16:11.
Nikkii is offline
Reply


Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump


All times are GMT -4. The time now is 06:21.


Powered by vBulletin®
Copyright ©2000 - 2024, vBulletin Solutions, Inc.
Theme made by Freecode