29 lines
911 B
Markdown
29 lines
911 B
Markdown
# 專案總覽
|
||
|
||
## 簡介
|
||
|
||
`lastz-giftcenter-cli` 是一個輕量的 Python 命令列工具，用於與 Last-Z Gift Center（`https://giftcenter.last-z.com`）互動，提供帳號查詢與禮品碼兌換功能。
|
||
|
||
## 檔案結構
|
||
|
||
| 檔案 | 說明 |
|
||
|------|------|
|
||
| `giftcenter.py` | 主程式，包含所有邏輯 |
|
||
| `requirements.txt` | Python 依賴套件 |
|
||
| `.env` | 本地環境設定（UID） |
|
||
|
||
## 功能
|
||
|
||
| 指令 | API 端點 | 說明 |
|
||
|------|----------|------|
|
||
| `login` | `GET /getcodeuser.php` | 查詢帳號名稱、SID、國家、等級 |
|
||
| `redeem <code>` | `GET /code.php` | 兌換禮品碼 |
|
||
|
||
## 技術細節
|
||
|
||
- **語言**：Python 3
|
||
- **依賴**：`requests`、`python-dotenv`
|
||
- **認證**：UID 透過 query string 及 `Usertoken` header 傳遞
|
||
- **錯誤處理**：login 使用數字錯誤碼，redeem 使用字串錯誤碼（`"ok"` 代表成功）
|
||
- **介面語言**：繁體中文
|