Mga Team
Sa teams, puwedeng sabay na mag-may-ari ng isang set ng applications ang maraming developer. Discord parity: parehong apat na roles, parehong one-way na transfer model, dagdag pa ang App Testers roster na lumalampas sa public/private gate para sa apps na dine-develop pa.
Mga Role
| Role | Puwedeng mag-edit ng app | Puwedeng mag-manage ng team | Puwedeng mag-delete ng app |
|---|---|---|---|
| May-ari | Oo | Oo (kasama ang pag-transfer ng ownership) | Oo |
| Admin | Oo | Oo (members, testers) | Hindi |
| Developer | Oo | Hindi | Hindi |
| Read-only | Hindi | Hindi | Hindi |
Ang effective role sa isang app = ang role ng team member, maliban kung ang nagre-request ay siya ring personal owner (ang pinagmulan ng transfer), kung saan Owner-level access ang applicable.
Mga Invite
- Admin pataas ang nagpapadala ng invite sa email sa isang existing na GameVox user.
- Makikita ng na-invite ang pending na invite sa portal home nila at puwede nila itong tanggapin o tanggihan.
- Puwedeng bawiin ang invites anumang oras bago ito tanggapin.
- Para ipadala ulit: bawiin, tapos i-invite ulit. (Walang hiwalay na “resend” button.)
Pag-transfer ng application
Puwedeng i-transfer ang personal apps sa team na pag-aari mo o kung saan ka admin. Kailangan mong i-type ang pangalan ng app sa transfer dialog para mag-confirm. Pagkatapos ng transfer:
- Ang team na ang may-ari ng app row. Kina-clear ang
owner_user_id; sine-set angowner_team_id. - Valid pa rin ang lahat ng existing na tokens (bot tokens, client secrets, webhook tokens): hindi sila nire-rotate ng transfer.
- Walang pagbabago sa storage prefixes ng app icon / cover, kaya gumagana pa rin ang assets nang hindi nire-re-upload.
- One-way ang transfer (tugma sa Discord). Para mag-“untransfer,” gumawa ng bagong personal app at manual na ilipat ang data.
Mga icon ng team
Mag-upload mula sa General tab ng team. Parehong image-upload widget ng app icons, may hiwalay na S3 prefix (team-icons/{team_id}/). Lumalabas sa team list page, sa team detail header, at bilang maliit na overlay sa app cards ng apps na pag-aari ng team na iyon.
App Testers
Per-application ang testers roster (hindi per-team), kaya may sariling listahan ang bawat app ng team. Puwedeng mag-install ang testers ng private app (naka-off ang public toggle) gamit ang normal na OAuth install URL; not-found page naman ang makikita ng sinumang wala sa roster.
- 100 testers kada application.
- Ginagawa ang invites gamit ang GameVox user-id o email. Auto-accept kapag inimbitahan mo ang sarili mo (trusted ka na).
- Walang access ang testers sa portal page ng application: install permission lang ang nakukuha nila.
- Hindi binabawi ng pag-alis ng tester ang anumang tokens na nakuha na niya sa OAuth; i-revoke ang mga iyon nang hiwalay.
Endpoints (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}