ecapi-sdk (Python)
ECAPI 的 Python SDK，面向当前重构后的 REST/OpenAPI 契约。当前门面由 openapi.json 生成并覆盖全部 160 个接口，并随包提供 py.typed 与 client.pyi，方便 IDE 显示参数、必填字段和 docstring。
安装
pip install ecapi-sdk
仓库内更新 SDK 文档和类型提示：
python3 sdk/generate_sdk_api_reference.py
python3 -m py_compile sdk/python/ecapi-sdk/src/ecapi_sdk/client.py
快速开始
from ecapi_sdk import ECAPIClient, ECAPIError, is_ecapi_error
client = ECAPIClient(
base_url="https://api.easecation.net",
auth={"type": "apiKey", "apiKey": "ec_xxx"},
)
try:
me = client.user.get_me()
player = client.player.get_info({"displayName": "Steve"})
wallet = client.player.get_wallet("player-ecid")
except ECAPIError as error:
print(error.status, error.code, error.request_id, str(error))
raise
认证方式
client.set_api_key("ec_xxx")
client.set_bearer_token("iam-jwt-token")
client.set_app_session_token("app-session-token")
client.clear_auth()
也可以在单次请求中传入 auth=... 覆盖默认认证；传 auth=None 表示本次不发送认证。
认证来自 IAM callback、短期 token 或其它动态来源时，可以使用 auth_provider，SDK 会在每次请求前调用它：
client = ECAPIClient(
auth_provider=lambda: {"type": "apiKey", "apiKey": get_current_api_key()},
)
如果 auth_provider 返回 awaitable，且当前没有正在运行的 event loop，同步客户端会用 asyncio.run() 等待它；在已有 event loop 中请使用同步 provider 或在业务层先解析认证。
类型提示与文档
client.py与client.pyi均从 OpenAPI 生成，query/body 会生成TypedDict，字段必填性来自 OpenAPI。API_REFERENCE.md会列出方法、接口说明、权限、HTTP 方法、路径、必填参数和可选参数。ECAPIError会提取服务端错误 envelope 中的code、request_id、details、field和用户友好的message。
常用调用
client.system.get_health()
client.system.get_liveness()
client.system.get_readiness()
client.player.search_ecid({"search": "Steve"})
client.player.cutoff_leaderboard.get_leaderboard({"game": "bedwar"})
client.server.leaderboard.get_top({
"game": "labour",
"scoreType": "ONLINE",
"deadlineType": "WEEK",
})
client.player.leaderboard.get_rank("player-ecid", {
"game": "labour",
"scoreType": "ONLINE",
"deadlineType": "MONTH",
})
client.punish.create({
"type": "WARNING",
"ecid": "player-ecid",
"source": "console",
"reason": "测试警告",
})
未封装或临时接口可使用统一入口：
client.request("GET", "/players/info", query={"displayName": "Steve"})
契约说明
本 SDK 不提供旧路径兼容别名，所有方法都调用新的 REST/OpenAPI 路径。OpenAPI 是路径、参数和权限说明的唯一事实源，完整方法请查看 API_REFERENCE.md。
1 maintainer
Release files for ecapi-sdk 3.5.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ecapi_sdk-3.5.4.tar.gz | 23.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ecapi_sdk-3.5.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 45.3 kB
Release files / ecapi_sdk-3.5.4.tar.gz
| Download URL | ecapi_sdk-3.5.4.tar.gz |
|---|---|
| Size | 23.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5c2df8ebe6f8301742f863becce80709f94f0a8613c08ea8ffdaf7226c15c03c
|
|
BLAKE2b-256 checksum How to use checksums |
6c6b90ccc74d7a959e062ff9a02f7eb646b22add4a7e603e33f535ab0e433f49
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / ecapi_sdk-3.5.4-py3-none-any.whl
| Download URL | ecapi_sdk-3.5.4-py3-none-any.whl |
|---|---|
| Size | 21.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3fffa05ab40e9aa9a632bbe21ff125f40dd230295a5fbf524c705fd061f54177
|
|
BLAKE2b-256 checksum How to use checksums |
1b511160026bff0f2654bf8111dcb3f10dfe8b4f7d5bf9c2c0631a5f3ba7f753
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
