A PHP Wrapper for the Tools4Games API
Examples are in test.php
You need to create an API Key @ http://blacklist.tools4games.com
https://github.com/roennel/T4G-API-Wrapper#endpoint-server
https://github.com/roennel/T4G-API-Wrapper#endpoint-servers
https://github.com/roennel/T4G-API-Wrapper#endpoint-player
$api = new API;
$api->auth('api_key', 'api_secret');$test = $api->getBlacklist(); // <- Get the Blacklist Section of the API (Currently the only one)
$test = $test->getServer(['serverId' => 16]); // <- Get the Server, either by serverId or bookmarkLink
$test = $test->events(); // <- Fetches the Server Events
$test = $test->status(); // <- Fetches the Server Status
$test = $test->players(); // <- Fetches the Server Players
$test = $test->chat(); // <- Fetches the Server Chat
$test = $test->kicklog(); // <- Fetches the Server Kicklog
$test = $text->execute(); // <- Execute the Command and return the Response as PHP Object
// You can also Chain those Methods into one Call, like so:
$test = $api->getBlacklist()->getServer(['serverId' => 16])->events()->status()->execute();Available Filters:
| Key | Values | Description |
|---|---|---|
| serverId | int | Filter by T4G ServerId |
| bookmarkLink | string | Filter by BookmarkLink |
Available Sub-Requests:
| Class | Filters |
|---|---|
| events() | - |
| chat() | search = string (Searches for occurences in Message) |
| players() | team = RU/US (Filters by Team) |
| status() | - |
| kicklog() | - |
Example Response:
{
"success": true,
"info": {
"hoster": "leetservers",
"country": "DE",
"bookmarkLink": "17a6ef60-3da2-4b77-b31f-9f4751622a75",
"online": true,
"disabled": false,
"noLogin": false,
"pbucon": {
"enabled": true,
"lastHeartbeat": "1399323452",
"tick": {
"period": 300,
"type": "seconds"
}
},
"backend": {
"duration": "0.093081",
"lastHeartbeat": "1399324410",
"tick": {
"period": 1,
"type": "seconds"
}
},
"blacklist": {
"blacklists": [
{
"blacklistId": "1",
"kicks": "3340",
"label": "Cheating"
},
...
],
"whitelist": [
]
}
},
"status": {
"name": "P4F Tools #2 - Sharqi Rush (NO SHOTGUNS) \/ Leetservers",
"map": "sharqi",
"gameMode": "gpm_rush",
"players": {
"current": "27",
"max": "32",
"joining": "1"
},
"tickets": {
"RU": "24",
"US": "-9899"
},
"time": {
"elapsed": "127",
"remaining": "-1"
}
},
"chat": [
{
"hash": "4c7038e530fbb72ba631a3b9260416bfac45f031",
"origin": "hallo????",
"type": "Global",
"time": "1399314212",
"message": "hacker",
"index": "11"
},
...
],
"players": [
{
"index": "5",
"team": "RU",
"ping": "148",
"connected": "1",
"alive": "1",
"manDown": "0",
"profileId": "808581318",
"suicide": "0",
"timeToSpawn": "0",
"score": "600",
"nucleusId": "2807858490",
"vip": "0",
"kills": "3",
"deaths": "0",
"suicides": "0",
"revives": "0",
"damageAssists": "0",
"passengerAssists": "0",
"targetAssists": "0",
"cpCaptures": "0",
"cpDefends": "0",
"cpAssists": "0",
"cpNeutralizes": "0",
"cpNeutralizeAssists": "0",
"joined": "1399314052",
"playingFor": 262,
"soldiers": [
{
"kit": "1",
"level": "0",
"name": "ACO78"
},
{
"kit": "0",
"level": "25",
"name": "AS78"
}
]
},
...
],
"events": [
{
"date": "1399314310",
"profileId": "497184881",
"event": "damageAssist"
},
{
"date": "1399314310",
"profileId": "517588597",
"event": "death"
},
...
],
"kicklog": [
{
"soldierId": "820131201",
"name": "azefdf",
"nucleusId": "2815327564",
"date": "1399309656",
"ban": {
"type": "Cheating",
"since": "1366228383"
}
},
...
]
}$servers = $api->getBlacklist()->getServers
([
'online' => true
])->execute(); // Get All Online ServersAvailable Filters:
| Key | Values | Description |
|---|---|---|
| online | false/true | Show Online Servers |
| disabled | false/true | Show Disabled Servers |
| noLogin | false/true | Show Servers with no Valid Login Data |
Example Response:
{
"success": true,
"servers": [
{
"serverId": "14",
"country": "DE",
"name": "Honey Badgers EU",
"bookmarkLink": "75d50a87-2b3a-431d-8683-e37f14d9e2b8",
"created": "0",
"hoster": "branzone",
"disabled": false,
"online": true,
"noLogin": false,
"players": {
"current": "28",
"max": "32",
"joining": "1"
},
"tickets": {
"ru": "0",
"us": "-9899",
"max": "100"
},
"time": {
"elapsed": "9",
"remaining": "-1"
},
"map": "downtown",
"gameMode": "gpm_rush",
"pbucon": {
"enabled": true,
"lastHeartbeat": "1399326294",
"tick": {
"period": 300,
"type": "seconds"
}
},
"backend": {
"duration": "0.156991",
"lastHeartbeat": null,
"tick": {
"period": 1,
"type": "seconds"
}
},
"blacklists": [
{
"blacklistId": "1",
"kicks": "2134",
"label": "Cheating"
},
{
"blacklistId": "2",
"kicks": "975",
"label": "Statspadding"
},
{
"blacklistId": "3",
"kicks": "50",
"label": "Glitching"
},
{
"blacklistId": "5",
"kicks": "0",
"label": "Macro"
}
]
},
...
}
}Example:
$test = $api->getBlacklist()->getPlayer
([
'nucleusId' => 2574913502
])->execute();Available Filters:
| Key | Values | Description |
|---|---|---|
| nucleusId | int | Filter by Nucleus ID |
Example Response:
{
"success": true,
"players": [
{
"nucleusId": "2574913502",
"soldierId": "550747325",
"kit": "0",
"level": "30",
"name": "kramarius",
"playing": false,
"activities": [
{
"action": "leave",
"date": "1396624302",
"server": {
"name": "P4F-Ballerbude",
"serverId": "1294",
"bookmarkLink": "d013fa4c-6054-406f-8866-c5b556c7b681"
}
},
{
"action": "join",
"date": "1396624082",
"server": {
"name": "P4F-Ballerbude",
"serverId": "1294",
"bookmarkLink": "d013fa4c-6054-406f-8866-c5b556c7b681"
}
}
],
"submissions": [
{
"created": "1397340363",
"type": "Cheating",
"done": "1"
},
{
"created": "1397204594",
"type": "Cheating",
"done": "1"
},
{
"created": "1396047286",
"type": "Cheating",
"done": "1"
},
{
"created": "1381416718",
"type": "Cheating",
"done": "1"
}
],
"bans": [
{
"banId": "42327",
"blacklistId": "1",
"created": "1397558616",
"active": "1",
"type": "Cheating"
}
]
}
]
}