Š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
- 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.
- Upiši povratnu adresu, npr.
https://tvoj-sajt.example/callback. Dok razvijaš može ihttp://localhost:5173/callback. - Pošalji člana na ekran pristanka. Kako se pravi adresa piše na stranici Prijava preko BalkTalka.
- Kad se član vrati na tvoju povratnu adresu, zamijeni kod za token.
- 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.