What you get
- Sign in with BalkTalk. A member does not create a new account and never gives you a password. On the consent screen they see exactly what you ask for.
- A public API at
https://www.balktalk.net/api/dev/v1: who is signed in, public profiles, your app leaderboards and the “is playing …” indicator in chats. - The app catalog. A public app opens in a frame on BalkTalk, with no second sign-in.
Who can create apps
- The account is older than 30 days.
- The e-mail address is confirmed.
- Two-step sign-in is on (Settings → Security and access).
- You can have at most 5 apps.
Your first app in five steps
- Open the portal and create an app. Choose whether it has its own server. With a server you get a client secret; without one (an app that runs only in the browser or on a phone) you use PKCE.
- Enter a redirect address, for example
https://your-site.example/callback. While developing,http://localhost:5173/callbackworks too. - Send the member to the consent screen. How to build the address is on the Sign in with BalkTalk page.
- When the member returns to your redirect address, exchange the code for a token.
- Call the API:
curl https://www.balktalk.net/api/dev/v1/me \
-H "Authorization: Bearer YOUR_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"
}
}
App states
| State | Who can grant access | Limit |
|---|---|---|
| In development | you and up to 25 testers | 120 requests per minute |
| In review | same as in development | same as in development |
| Public | every member | 1.200 requests per minute |
| Suspended | nobody, all tokens stop working | – |
You send an app for review from the portal. Review needs a short description, a description, an icon, the address of your privacy policy and at least one address that is not a development address. The administrators approve it or return it with a reason.
When a public app asks for new scopes or a different frame address, that change waits for a new review. Until the decision the app keeps working with the old values.
What is not available
The public API never gives private messages, e-mail addresses, location, data from Upoznaj, verification, or anything from moderation and administration. An app cannot post in a member's name. Ducats are not used in third-party apps.
Rules
Read the Developer terms before you publish (the link is in the documentation menu). In short: take only the data you need, do not scrape, delete a member's data when they remove your access, and do not present yourself as BalkTalk.