# JK ID

> jkgame.com 的統一會員系統（Hong Kong, since 1997）。玩家用一個帳號登入站上多款遊戲；
> 遊戲永遠不會接觸到玩家的 JK ID 密碼。第三方遊戲用標準 OAuth 2.0（授權碼 + PKCE）接入。

接入這個服務之前，請先讀完整指南；它列出全部端點、參數、錯誤碼與必須遵守的規則。

## Docs

- [接入指南（完整，Markdown）](https://id.jkgame.com/docs/jk-id.md): OAuth 2.0 流程、partner API、
  同機遊戲的 auth_request 方式、規則與上線檢查表
- [申請接入](https://id.jkgame.com/developers): 申請 client_id／client_secret，管理 redirect URI
- [支援 JK ID 的遊戲](https://id.jkgame.com/games): 目前已接入的清單

## Endpoints

- https://id.jkgame.com/oauth/authorize (GET/POST): 授權碼，必須 PKCE S256
- https://id.jkgame.com/oauth/token (POST): grant_type=authorization_code | refresh_token
- https://id.jkgame.com/oauth/revoke (POST)
- https://id.jkgame.com/api/v1/partner/userinfo (GET, scope identity)
- https://id.jkgame.com/api/v1/partner/link (GET/POST, scope link)
- https://id.jkgame.com/api/v1/partner/wallet (GET, scope points.read)
- https://id.jkgame.com/api/v1/partner/wallet/spend (POST, scope points.spend, 需要 idempotency_key)

## Notes

- 沒有 OpenID Connect discovery、沒有 id_token、沒有 implicit 與 client_credentials。
- redirect_uri 完整比對，不接受萬用字元；http 只限 localhost。
- `sub` 是 pairwise（每個應用不同），是唯一可以用來認人的鍵。
- 應用要由站方批准之後才可以簽入玩家。