BalkTalk

Za developere

Početak

Napravi aplikaciju ili igru povezanu sa BalkTalkom: članovi se prijavljuju svojim BalkTalk nalogom, a ti preko javnog API-ja dobijaš samo ono što ti odobre.

Šta dobijaš

  • Prijava preko BalkTalka. Član ne pravi novi nalog i ne daje ti lozinku. Na ekranu pristanka vidi tačno šta tražiš.
  • Javni API na https://www.balktalk.net/api/dev/v1: ko je prijavljen, javni profili, rang liste tvoje aplikacije i prikaz „igra …” u razgovorima.
  • Katalog aplikacija. Javna aplikacija se otvara u okviru na BalkTalku, bez ponovne prijave.

Ko može praviti aplikacije

  • Nalog je stariji od 30 dana.
  • E-mail adresa je potvrđena.
  • Uključena je dvostepena prijava (Postavke → Sigurnost i pristup).
  • Možeš imati najviše 5 aplikacija.

Prva aplikacija u pet koraka

  1. Otvori portal i napravi aplikaciju. Izaberi ima li svoj server. Sa serverom dobijaš tajni ključ, bez njega (aplikacija samo u pregledniku ili na telefonu) koristiš PKCE.
  2. Upiši povratnu adresu, npr. https://tvoj-sajt.example/callback. Dok razvijaš može i http://localhost:5173/callback.
  3. Pošalji člana na ekran pristanka. Kako se pravi adresa piše na stranici Prijava preko BalkTalka.
  4. Kad se član vrati na tvoju povratnu adresu, zamijeni kod za token.
  5. Pozovi API:
curl https://www.balktalk.net/api/dev/v1/me \
  -H "Authorization: Bearer TVOJ_TOKEN"
{
  "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"
  }
}

Stanja aplikacije

Stanje Ko može odobriti pristup Ograničenje
U razvoju ti i do 25 testera 120 zahtjeva u minuti
Na pregledu isto kao u razvoju isto kao u razvoju
Javna svaki član 1.200 zahtjeva u minuti
Suspendovana niko, svi tokeni prestaju važiti –

Aplikaciju šalješ na pregled iz portala. Za pregled trebaju kratak opis, opis, ikona, adresa tvoje politike privatnosti i bar jedna adresa koja nije adresa za razvoj. Administracija je odobri ili vrati uz obrazloženje.

Kad javna aplikacija zatraži nove dozvole ili drugu adresu okvira, ta izmjena čeka novi pregled. Do odluke aplikacija radi sa starim.

Šta nije dostupno

Javni API nikad ne daje privatne poruke, e-mail adrese, lokaciju, podatke iz Upoznaj, verifikaciju ni bilo šta iz moderacije i administracije. Aplikacija ne može objavljivati u ime člana. Dukati se u aplikacijama trećih strana ne koriste.

Pravila

Prije objave pročitaj Uslove za developere (link je u meniju dokumentacije). Najkraće: uzimaj samo podatke koji ti trebaju, ne skidaj podatke masovno, obriši podatke člana kad ti ukine pristup i ne predstavljaj se kao BalkTalk.

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