Zespoły

Zespoły pozwalają wielu deweloperom wspólnie posiadać zestaw aplikacji. Zgodność z Discordem: te same cztery role, ten sam jednokierunkowy model przenoszenia, a do tego lista testerów aplikacji, która omija blokadę publiczna/prywatna dla aplikacji w trakcie tworzenia.

Role

Rola	Edycja aplikacji	Zarządzanie zespołem	Usuwanie aplikacji
Właściciel	Tak	Tak (w tym przeniesienie własności)	Tak
Administrator	Tak	Tak (członkowie, testerzy)	Nie
Deweloper	Tak	Nie	Nie
Tylko do odczytu	Nie	Nie	Nie

Efektywna rola w aplikacji to rola członka zespołu, chyba że osoba wysyłająca żądanie jest też osobistym właścicielem (źródłem przeniesienia). Wtedy obowiązuje dostęp na poziomie Właściciela.

Zaproszenia

Administrator lub wyżej wysyła zaproszenie e-mailem do istniejącego użytkownika GameVox.
Zaproszona osoba widzi oczekujące zaproszenie na stronie głównej portalu i je przyjmuje lub odrzuca.
Zaproszenie można wycofać w dowolnym momencie przed przyjęciem.
Aby wysłać ponownie: wycofaj, a potem zaproś jeszcze raz. (Nie ma osobnego przycisku „wyślij ponownie”.)

Przenoszenie aplikacji

Aplikacje osobiste można przenieść do zespołu, którego jesteś właścicielem lub administratorem. Okno przeniesienia wymaga wpisania nazwy aplikacji w celu potwierdzenia. Po przeniesieniu:

Właścicielem wiersza aplikacji jest zespół. owner_user_id jest czyszczone; ustawiane jest owner_team_id.
Wszystkie istniejące tokeny (tokeny botów, client secrety, tokeny webhooków) pozostają ważne: przeniesienie ich nie rotuje.
Prefiksy przechowywania ikony i okładki aplikacji się nie zmieniają, więc zasoby działają dalej bez ponownego wgrywania.
Przeniesienie jest jednokierunkowe (tak jak na Discordzie). Aby je „cofnąć”, utwórz nową aplikację osobistą i ręcznie przenieś dane.

Ikony zespołów

Wgrywasz je w zakładce Ogólne zespołu. Ten sam widżet wgrywania obrazów co dla ikon aplikacji, z osobnym prefiksem S3 (team-icons/{team_id}/). Ikona wyświetla się na liście zespołów, w nagłówku strony zespołu oraz jako mała nakładka na kartach aplikacji należących do tego zespołu.

Testerzy aplikacji

Lista testerów jest przypisana do aplikacji (nie do zespołu), więc każda aplikacja zespołu ma własną listę. Testerzy mogą zainstalować prywatną aplikację (z wyłączonym przełącznikiem publicznej) przez zwykły URL instalacji OAuth; każdy spoza listy widzi stronę „nie znaleziono”.

100 testerów na aplikację.
Zaproszenia wysyła się po identyfikatorze użytkownika GameVox lub adresie e-mail. Zaproszenie samego siebie jest przyjmowane automatycznie (masz już zaufanie).
Testerzy nie mają dostępu do strony aplikacji w portalu: dostają wyłącznie uprawnienie do instalacji.
Usunięcie testera nie unieważnia tokenów, które tester już uzyskał przez OAuth; unieważnij je osobno.

Endpointy (portal)

GET    /developer-portal/teams
POST   /developer-portal/teams
GET    /developer-portal/teams/{id}
PATCH  /developer-portal/teams/{id}
DELETE /developer-portal/teams/{id}

GET    /developer-portal/teams/{id}/members
POST   /developer-portal/teams/{id}/members        {email, role}
PATCH  /developer-portal/teams/{id}/members/{user_id}  {role}
DELETE /developer-portal/teams/{id}/members/{user_id}

POST   /developer-portal/applications/{id}/transfer  {team_id, app_name}

GET    /developer-portal/applications/{id}/testers
POST   /developer-portal/applications/{id}/testers   {email|user_id}
DELETE /developer-portal/applications/{id}/testers/{user_id}

← Powrót do dokumentacji