BUZZERBEATER / DEVELOPERS

Crea per il gioco.

Strumenti per la community, piani di allenamento, statistiche di lega. Tutto ciò che serve per collegare la tua idea a BuzzerBeater.

Migrating from bbapi

The legacy bbapi.buzzerbeater.com served XML pages to a session opened with the manager's login name and read-only access code. The public API keeps the same idea — read the game for a manager — and changes how.

What changes

bbapiPublic API v1
XML, one RelaxNG schemaJSON, OpenAPI document at /v1/public.json
login.aspx?login=…&code=… in the URL, then a cookieOAuth 2.0 with PKCE, or a personal token; always in the Authorization header
The access code gives everything the account seesThe manager chooses scopes, and can revoke each tool on its own
Integer idsUUIDs (strings)
secondteam=1 to switch teamEvery club and national team the manager runs is listed by /v1/me; pass its id
No documented limitsPer-minute, daily and breadth limits, reported in headers
Errors as <error message="…"/> with HTTP 200HTTP status codes plus {"error":{"code","description"}}

Legacy ids do not carry over: the new game is a new world. A tool that stored legacy ids should start its data afresh.

Page by page

bbapi pagev1Scope
login.aspx, logout.aspxOAuth sign-in, POST /v1/oauth/revoke—
teaminfo.aspx?teamid=GET /v1/teams/{teamId}public
roster.aspx?teamid=GET /v1/teams/{teamId}/rosterpublic (+ team for own skills)
player.aspx?playerid=GET /v1/players/{playerId}public
schedule.aspx?teamid=&season=GET /v1/teams/{teamId}/schedule?season=public
teamstats.aspx?teamid=&season=&mode=GET /v1/teams/{teamId}/stats?season=&mode=averages|totalspublic
arena.aspx?teamid=GET /v1/teams/{teamId}/arenapublic
boxscore.aspx?matchid=GET /v1/matches/{matchId}/boxscorepublic
pbp.aspxnot offered: the play-by-play is part of the match viewer, not of the data API—
standings.aspx?leagueid=&season=GET /v1/competitions/{competitionId}/standings?season=public
seasons.aspxGET /v1/seasonspublic
countries.aspxGET /v1/countriespublic
leagues.aspx?countryid=&level=GET /v1/countries/{countryId}/leagues?level=public
economy.aspxGET /v1/teams/{teamId}/economyeconomy

New in v1

Whatv1Scope
National team squadGET /v1/national-teams/{teamId}/roster (and GET /v1/countries/{countryId}/national-teams to find it)public (+ national for skills)
Transfer listGET /v1/market/players?…, GET /v1/market/players/{playerId}/auctionmarket
Training now and history, with coach, youth coach and facility levels and players' minutesGET /v1/teams/{teamId}/training, …/training/historyteam
A player's training historyGET /v1/players/{playerId}/trainingteam
Staff and facilitiesGET /v1/teams/{teamId}/staff, …/facilitiesteam
SalariesGET /v1/teams/{teamId}/economy/salarieseconomy
National team training (as its coach)GET /v1/national-teams/{teamId}/training/historynational