BalkTalk

Za developere

Referenca API-ja

Sve adrese javnog API-ja, sa dozvolom koju traže i primjerom odgovora. Spisak nastaje iz koda, pa je uvijek jednak onome što server zaista radi.

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.

OpenAPI opis (JSON)

Neophodni kolačići drže sajt u radu. Uz tvoj pristanak koristimo i dodatne (npr. analitiku) - izbor možeš promijeniti bilo kada. Politika kolačića

Neophodni kolačići drže sajt u radu. Uz tvoj pristanak koristimo i dodatne (npr. analitiku) - izbor možeš promijeniti bilo kada. Politika kolačića

Neophodni

Uvijek aktivno

Bez njih sajt ne radi: prijava, sigurnost, jezik i tvoji izbori. Ne traže pristanak i ne koriste se za praćenje.

  • bt_session kolačić · 30 dana

    Sesija: drži te prijavljenim dok koristiš sajt.

    BalkTalk

  • XSRF-TOKEN kolačić · 30 dana

    Zaštita formulara od lažnih zahtjeva (CSRF).

    BalkTalk

  • remember_web_* kolačić · 13 mjeseci

    „Zapamti me”: prijava ostaje i poslije zatvaranja preglednika.

    BalkTalk

  • bt_locale kolačić · 12 mjeseci

    Jezik koji si izabrao.

    BalkTalk

  • bt_2fa_device kolačić · 30 dana

    Dvostepena prijava: ovaj uređaj ne traži kod 30 dana (kad izabereš „Zapamti ovaj uređaj”).

    BalkTalk

  • bt_consent kolačić · 12 mjeseci

    Tvoj izbor o kolačićima (da te ne pitamo ponovo).

    BalkTalk

  • bt-*, bt:* localStorage · dok ga ne obrišeš

    Lokalna memorija preglednika: tema, jezik, radio stanica, nedavni emojiji, raspored chata, sakrivene napomene.

    BalkTalk

  • bt_invite kolačić · 30 dana

    Ko te pozvao na BalkTalk (link pozivnice) – da oboje dobijete nagradu kad postaneš aktivan član.

    BalkTalk

  • Cloudflare Turnstile servis

    Provjera „Nisi robot” na registraciji (challenges.cloudflare.com) - štiti sajt od lažnih naloga.

    Cloudflare, Inc. · Pravila privatnosti

Vanjski sadržaj

Kad ga otvoriš

Video, muzika, GIF-ovi, radio i mapa dolaze sa servera drugih kompanija. Kad ih otvoriš, ti serveri vide tvoju IP adresu i mogu postaviti svoje kolačiće.

  • Google Identity Services servis

    Prijava jednim klikom sa Google nalogom na koji si prijavljen u pregledniku („Nastavi kao …”, accounts.google.com). Google pri tome vidi da si posjetio sajt, a ime i e-mail dobijamo tek kad klikneš „Nastavi”. Google može postaviti kolačić g_state koji pamti da si zatvorio ponudu.

    Google Ireland Ltd. · Pravila privatnosti

  • YouTube servis

    Video u blogu i chatu (youtube-nocookie.com).

    Google Ireland Ltd. · Pravila privatnosti

  • Deezer servis

    Isječci i omoti pjesama na profilu, Mreži i u chatu.

    Deezer S.A. · Pravila privatnosti

  • KLIPY servis

    GIF-ovi u chatu i komentarima.

    KLIPY Inc. · Pravila privatnosti

  • Radio stanice servis

    Prijenos uživo kad pokreneš radio.

    Server izabrane stanice

  • OpenStreetMap servis

    Mapa u modulu U blizini (samo uz poseban pristanak za mapu).

    OpenStreetMap Foundation · Pravila privatnosti

  • OneSignal servis

    Push obavijesti na ovom uređaju – učitava se tek kad ih uključiš u Postavkama.

    OneSignal, Inc. · Pravila privatnosti

Analitika

Anonimna statistika posjeta koja nam pomaže da poboljšamo sajt. Samo uz tvoj pristanak.

  • Google Analytics servis

    Statistika posjeta (koje stranice se otvaraju, odakle dolaze posjetioci, uređaj) - bez reklama. Učitava se samo uz tvoj pristanak.

    Google Ireland Ltd. · Pravila privatnosti

  • _ga kolačić · 24 mjeseci

    Google Analytics: razlikuje posjetioce (nasumičan broj, bez imena i e-maila).

    Google Ireland Ltd. · Pravila privatnosti

  • _ga_0QPMP1EXWV kolačić · 24 mjeseci

    Google Analytics: pamti trenutnu posjetu.

    Google Ireland Ltd. · Pravila privatnosti