Osnove
- Osnovna adresa:
https://www.balktalk.net/api/dev/v1 - Svaki poziv nosi zaglavlje
Authorization: Bearer ACCESS_TOKEN. - Tijelo zahtjeva je JSON (
Content-Type: application/json). - Aplikacija uvijek radi u ime člana koji joj je odobrio pristup. Poziva bez člana nema.
- Oblik grešaka i ograničenja su na stranici Ograničenja i greške.
Adrese
Uz svaku adresu piše dozvola pristupa. Adrese označene kao upis imaju strože ograničenje (10 u minuti po članu).
Prijavljeni član
GET /me
Član koji je aplikaciji odobrio pristup. Uz dozvolu profile odgovor nosi i polje profile.
Dozvola: identity
Odgovor · 200
{
"data": {
"id": 48213,
"username": "ana",
"display_name": "Ana",
"avatar_url": "https://load.balktalk.net/media/…/avatar.webp",
"verified": true,
"profile_url": "https://www.balktalk.net/u/ana",
"profile": {
"about": "Kafa, kviz i dobra muzika.",
"age": 34,
"gender": "female",
"country_code": "DE",
"country_name": "Njemačka",
"location": "München",
"website": null,
"joined_at": "2024-03-02T10:15:00+00:00"
}
}
}
Javni profil člana
GET /users/{username}
Profil po korisničkom imenu, sa poljima koja se vide na tuđem profilu. Vraća 404 kad član ne postoji ili između njega i prijavljenog člana postoji blokada.
Dozvola: profile
Odgovor · 200
{
"data": {
"id": 5120,
"username": "bojan",
"display_name": "Bojan",
"avatar_url": "https://www.balktalk.net/app/avatars/neutral.svg",
"verified": false,
"profile_url": "https://www.balktalk.net/u/bojan",
"profile": {
"about": "Šah, planine i stari rok.",
"age": 41,
"gender": "male",
"country_code": "BA",
"country_name": "Bosna i Hercegovina",
"location": "Mostar",
"website": null,
"joined_at": "2023-09-18T08:40:00+00:00"
}
}
}
Rang liste aplikacije
GET /boards
Liste koje si napravio/la u portalu. Aplikacija vidi samo svoje.
Dozvola: identity
Odgovor · 200
{
"data": [
{
"key": "glavna",
"name": "Najbolji rezultati",
"order": "desc",
"format": "number"
}
]
}
Vrh rang liste
GET /boards/{key}/scores
Najboljih limit rezultata (zadano 20, najviše 50) kako ih vidi prijavljeni član, i njegov rezultat sa mjestom. me je null dok nema rezultat.
Dozvola: identity
Parametri
?limit=20
Odgovor · 200
{
"data": [
{
"rank": 1,
"score": 18450,
"achieved_at": "2026-11-15T19:42:07+00:00",
"user": {
"id": 5120,
"username": "bojan",
"display_name": "Bojan",
"avatar_url": "https://www.balktalk.net/app/avatars/neutral.svg",
"verified": false,
"profile_url": "https://www.balktalk.net/u/bojan"
}
}
],
"me": {
"rank": 7,
"score": 9120,
"achieved_at": "2026-11-14T21:03:55+00:00",
"user": {
"id": 48213,
"username": "ana",
"display_name": "Ana",
"avatar_url": "https://load.balktalk.net/media/…/avatar.webp",
"verified": true,
"profile_url": "https://www.balktalk.net/u/ana"
}
},
"board": {
"key": "glavna",
"name": "Najbolji rezultati",
"order": "desc",
"format": "number"
}
}
Upiši rezultat
PUT /boards/{key}/scores/me
Rezultat prijavljenog člana. Ostaje samo ako je bolji od dosadašnjeg; improved kaže da li je ovaj poziv postavio novi najbolji. Za listu formata time šalji milisekunde.
Dozvola: scores
Upis (strože ograničenje)
Tijelo zahtjeva
{
"score": 9120
}
Odgovor · 200
{
"data": {
"rank": 7,
"score": 9120,
"achieved_at": "2026-11-14T21:03:55+00:00",
"user": {
"id": 48213,
"username": "ana",
"display_name": "Ana",
"avatar_url": "https://load.balktalk.net/media/…/avatar.webp",
"verified": true,
"profile_url": "https://www.balktalk.net/u/ana"
}
},
"improved": true
}
Član koristi aplikaciju
POST /activity
Važi oko dvije minute - dok član igra, javljaj se jednom u minuti. Ko to vidi određuju njegove postavke privatnosti na BalkTalku.
Dozvola: activity
Upis (strože ograničenje)
Odgovor · 204
Bez tijela.
Član je prestao koristiti aplikaciju
DELETE /activity
Odmah uklanja prikaz „igra …”.
Dozvola: activity
Odgovor · 204
Bez tijela.