fisk/steamrep

steamrep.com web API wrapper

SteamRep PHP API

Provides bindings for the public SteamRep web APIs to fetch reputation for a user., _(*1)

Composer

composer require fisk/steamrep

Usage

Typical usage is as follows:, _(*2)

<?php
use SteamRep\SteamRep;

$client = new SteamRep();
$response = $client->getUser("76561197971691194");

$tags = $response->getReputation()->getTags();

foreach ($tags as $tag) {
    print("{$tag->getAuthority()} {$tag->getStatus()}\n"); // SR ADMIN
}

SteamRepResponse

SteamRepResponse is the response object for a successful call., _(*3)

isValid(): bool

Although a call to the SteamRep API may be successful, the input SteamId64 may be incorrect, or refers to a profile not yet tracked on SteamRep., _(*4)

This asserts that the value of steamrep.flags.status is valid., _(*5)

getLastSyncTime(): int

Get the time of the last update for the SteamRep profile., _(*6)

getReputation(): Reputation

Returns a Reputation entity which provides helper functions for the steamrep.reputation document., _(*7)

getStats(): Stats

Returns a Stats entity which provides helper functions for the steamrep.stats document., _(*8)

Reputation

The Reputation class exposes the reputation data for a user., _(*9)

getSummary(): string

Returns the value provided by steamrep.reputation.summary. Known values are as follows:, _(*10)

• none
• SCAMMER
• CAUTION
• ADMIN
• MIDDLEMAN
• TRUSTED SELLER (disused)

getTagString(): string

A delimited list of tag names provided by steamrep.reputation.full., _(*11)

Tags in the tag string are sorted by tag category, with miscellaneous tags appearing last., _(*12)

getTags(): Tag[]

Returns an array of Tag objects representing the steamrep.reputation.tags document., _(*13)

Tags in this array are sorted in chronological order., _(*14)

Tag

A Tag represents a SteamRep tag, which consists of an authority and a status. This library supplies some helper methods to extract this information., _(*15)

getName(): string

Get the name for this tag, e.g. SOP ADMIN, _(*16)

getAuthority(): string

Get the authority for this tag, e.g. SOP, _(*17)

getStatus(): string

Get the status for this tag, e.g. ADMIN, _(*18)

getTimestamp(): int

Get the creation time of the tag as a UNIX timestamp., _(*19)

getDateTime(): DateTime

Get the creation time of the tag as a PHP DateTime object., _(*20)

NB: The SteamRep API provides a date string, however this does not include the timezone. If you need "SteamRep time", set the timezone of the returned object to CST6CDT., _(*21)

getCategory(): string

Get the category of the tag. This can be one of the following:, _(*22)

• trusted - indicates a trusted user group; partner community, middleman, SteamRep admin, etc.
• misc - used for the SteamRep donator label.
• evil - scammer tags.
• warning - caution tags.

Stats

getBannedFriendsCount(): int

Return the number of friends with SCAMMER tags., _(*23)

getUnconfirmedReportsCount(): int

Returns the count of unconfirmed reports (the number of forum threads with non-conclusive tags)., _(*24)

Error handling

• The client will throw a GuzzleException for Guzzle client errors, or a SteamRepException if the returned data is malformed., _(*25)

• Always check the SteamRepResponse isFound() method if you aren't totally sure about your inputs. This will be true if the requested SteamID64 is valid., _(*26)