add GetUserMusicApi & fix wrong in payload & add type args in UserLogoutApi & update README.md

This commit is contained in:
Nofated095 committed 2026-11-21 11:19:58 +08:00
1 parent 7139bd0951
commit 400413df45
4 files changed
+158 -15

No files matched your search

+88 -1
View File
@@ -1,3 +1,90 @@
# Kou
SDGA
A Python 3 based「maimai DX International」title server interaction emulator. Inspired by Fragrance/eaquira.
`SteamingAssets` dumped from .app file is required. Place it in the root of the project.
## Usage
Currently, Mifare AiME is the only supported type.
### `UserLoginApi`
#### Parameters & Returns
| Parameter | Type | Required |
| :--- | :--- | :--- |
| `--userId` | `int` | Yes |
| `--accessCode` | `str` | Yes |
| `--serial` | `str` | Yes |
| `--loginDateTime` | `int` | Yes |
Returns a two-element list containing ```[ResponseBodyFromTitleServer, CookiesFromTitleServer]```, both are string.
#### Example
```bash
python3 UserLogin.py \
--userId 6964139 \
--accessCode "01036000000000000000" \
--serial "00000000" \
--loginDateTime 1700000000
```
```
[
'{"returnCode":1,"lastLoginDate":"2026-11-21 11:09:25","loginCount":125,"consecutiveLoginCount":3,"loginId":7710449444398826983}',
'{"JSESSIONID": "85F1E8EABB944B94CB581BA05EC6A312"}'
]
```
---
### `UserLogoutApi`
#### Parameters & Returns
| Parameter | Type | Required |
| :--- | :--- | :--- |
| `--userId` | `int` | Yes |
| `--accessCode` | `str` | Yes |
| `--logoutType` | `int` | Version-dependent |
| `--loginDateTime` | `int` | Yes |
| `--cookie` | `str` | Yes |
Returns a string. Just the response from Title Server.
#### Example
```bash
python3 UserLogoutApi.py \
--userId 6964139 \
--accessCode "01036000000000000000" \
--logoutType 1 \
--loginDateTime 1700000000 \
--cookie '{"JSESSIONID":"TRGISALEAKER"}'
```
```
{'returnCode': 1}
```
---
## 3. `GetUserDataApi` / `GetUserChargeApi` / `GetUserExtendApi` / `GetUserMissionDataApi` / `GetUserOptionApi` / `GetUserRatingApi`
These scripts share the same parameter signature, requiring only `--userId` and `--cookie`.
### Parameters
| Parameter | Type | Required | Notes |
| :--- | :--- | :--- | :--- |
| `--userId` | `int` | Yes | - |
| `--cookie` | `str` | Yes | JSON string |
Returns a string. Just the response from Title Server.
### Examples
```bash
python3 GetUserData.py \
--userId 6964139 \
--cookie '{"JSESSIONID": "TRGISALEAKER"}'
```