Image API#
Serves logos, badges and photos for every entity in the platform, keyed by the same numeric ids the REST APIs return. No authentication. Practical usage guide: Working with images.
GET https://sports.bzzoiro.com/img/<type>/<id>/ football
GET https://sports.bzzoiro.com/img/<sport>/<type>/<id>/ other sports
Supported types#
| Sport | URL forms |
|---|---|
| Football | /img/player/{id}/ · /img/team/{id}/ · /img/league/{id}/ · /img/manager/{id}/ · /img/venue/{id}/ |
| Tennis | /img/tennis/player/{id}/ |
| Darts | /img/darts/player/{id}/ |
| Hockey | /img/hockey/team/{id}/ · /img/hockey/league/{id}/ |
| Basketball | /img/basketball/team/{id}/ · /img/basketball/league/{id}/ · /img/basketball/player/{id}/ · /img/basketball/manager/{id}/ · /img/basketball/venue/{id}/ |
| CS2 | /img/csgo/team/{id}/ · /img/csgo/player/{id}/ · /img/csgo/tournament/{id}/ |
An unknown type returns 404. /api/img/… is an equivalent alias for both
forms.
Modifiers#
| Param | Applies to | Effect |
|---|---|---|
?bg=transparent |
All types | Removes white background connected to the image edge |
?sor=true |
player (football) only |
Cut-out face-style photo when available; silent fallback to the regular photo |
Modifiers combine: ?sor=true&bg=transparent. Each variant is cached
separately, so the first request per variant is slower.
Response semantics#
| Case | Response |
|---|---|
| Image available | 200 — PNG or WebP (Content-Type set accordingly) |
| Valid id, no image | 204 No Content (empty body) — render your own placeholder |
Non-numeric/null id |
204 No Content |
| Unknown type | 404 |
The 204-instead-of-404 design means templates that interpolate optional ids never produce broken requests. Sport-scoped types are namespaced — a tennis id can never serve a football image.
Caching#
- Server/edge cache: up to 30 days per image (missing images re-checked hourly).
- Browser cache:
Cache-Control: public, max-age=31536000on cached images. - The
X-Cache-Statusheader reportsHIT/MISS. - First-ever request for an image fetches upstream (~1 s); after that it's served from cache.
Hotlink freely — the proxy exists so you don't have to download, store or resize images yourself.