BalkTalk

Za developere

Ograničenja i greške

Koliko poziva smiješ napraviti, šta dobiješ kad pređeš granicu i u kojem obliku stižu greške.

Ograničenja

Brojevi ispod su oni koji trenutno važe na ovom sajtu.

Šta se broji Granica
Svi pozivi aplikacije u razvoju ili na pregledu 120 u minuti
Svi pozivi javne aplikacije 1.200 u minuti
Pozivi u ime jednog člana 60 u minuti
Upisi u ime jednog člana (rezultati, aktivnost) 10 u minuti
Zahtjevi za token (kod, obnova) 30 u minuti

Uz to: najviše 5 aplikacija po developeru, 25 testera i 5 rang listi po aplikaciji.

Zaglavlja

Svaki odgovor nosi X-RateLimit-Limit i X-RateLimit-Remaining. Kad pređeš granicu, dobiješ 429 i zaglavlje Retry-After sa brojem sekundi:

{
  "error": "rate_limited",
  "message": "Previše zahtjeva. Pokušaj ponovo za 21 s.",
  "retry_after": 21
}

Sačekaj retry_after sekundi prije sljedećeg poziva. Nemoj odmah ponavljati.

Automatska suspenzija

Aplikacija koja stalno prelazi svoju granicu suspenduje se sama i ti dobiješ obavijest sa obrazloženjem. Suspendovanoj aplikaciji nijedan token ne važi. Kad ispraviš uzrok, javi se administraciji da ukine suspenziju.

Oblik greške

Sve greške javnog API-ja imaju isti oblik:

{ "error": "kod_greske", "message": "Tekst za developera" }

U kodu poredi polje error. Tekst u message se može promijeniti.

HTTP error Značenje
401 invalid_token token nedostaje, istekao je ili je pristup ukinut
403 insufficient_scope token nema dozvolu za ovaj poziv (naziv je u polju scope)
403 forbidden radnja nije dozvoljena
404 not_found nema toga, ili ga prijavljeni član ne smije vidjeti
422 validation_failed neispravni podaci, greške po polju su u errors
429 rate_limited previše zahtjeva, vidi retry_after
500 server_error greška kod nas, pokušaj kasnije

Primjer greške validacije:

{
  "error": "validation_failed",
  "message": "Polje score mora biti cijeli broj.",
  "errors": { "score": ["Polje score mora biti cijeli broj."] }
}

Oblik odgovora

  • Uspješan odgovor nosi podatke u polju data.
  • Datumi su ISO 8601 sa vremenskom zonom, npr. 2026-11-15T19:42:07+00:00.
  • Polje koje član ne prikazuje na profilu ima vrijednost null.
  • Nova polja mogu biti dodana bez najave. Postojeća polja ne mijenjamo i ne uklanjamo bez nove verzije API-ja.

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