📚 API 文档

完整的 RESTful API 接口文档和集成指南

📌 概述

所有 API 基于 HTTP POST,统一返回 JSON。请求需要携带 appkeysign 签名参数。

基础 URL:https://mm.steam68.art/api

🔐 认证方式

每个请求需要携带以下公共参数:

POST /api/{endpoint}
Content-Type: application/x-www-form-urlencoded

appkey=YOUR_APPKEY
timestamp=1716643200
sign=md5(appkey + appsecret + timestamp + data)

签名算法:sign = md5(appkey + appsecret + timestamp + postData)

🔑 用户登录

POST/api/login
用户登录验证,返回 token 和到期信息
POST /api/login
appkey=&username=testuser&password=123456&sign=xxx×tamp=xxx

返回:{"code":0,"msg":"ok","data":{"token":"xxx","expire_time":1716643200,"user_info":{...}}}

✅ 在线验证

POST/api/verify
验证用户 token 是否有效
POST /api/verify
appkey=&token=xxx&sign=xxx×tamp=xxx

返回:{"code":0,"msg":"ok","data":{"valid":true,"expire_time":1716643200}}

💓 心跳上报

POST/api/heartbeat
客户端定时上报心跳,保持在线状态
POST /api/heartbeat
appkey=&token=xxx&sign=xxx×tamp=xxx

💳 卡密充值

POST/api/recharge
使用卡密充值用户时长
POST /api/recharge
appkey=&cardnum=XXXX-XXXX-XXXX&sign=xxx×tamp=xxx

返回:{"code":0,"msg":"充值成功","data":{"days":30,"new_expire_time":1719235200}}

⚙️ 配置下发

POST/api/config
下发软件配置参数(公告、版本号、更新地址等)
POST /api/config
appkey=&sign=xxx×tamp=xxx

📱 设备绑定

POST/api/bind
绑定用户设备,返回 bind_id
POST /api/bind
appkey=&token=xxx&device_id=xxx&sign=xxx×tamp=xxx

🛠️ SDK 集成

我们提供以下语言的示例代码,帮助您快速集成:

C++Windows / Linux,WinHttp + md5
C#.NET Framework 4.0+ / .NET Core
JavaHttpURLConnection / OkHttp
Pythonrequests + hashlib
易语言精易模块 / 网页_访问

👉 请在 下载中心 获取完整的 SDK 源码包。