墨辞网络验证

API文档
错误码参照
示例代码

接口地址： https://mc.wsff.cn/api.php?api=userlist

返回格式： JSON

请求方式： GET

请求示例： https://xiaor2.wsff.cn/?api=userlist&app=10000 复制示例跳转示例

请求参数说明：

名称	变量	必填	类型	说明
接口	api	是	GET	填写userlist
应用	app	是	GET	填写后台应用APPID
每页数量	num	否	GET/POST	每页返回用户数量，默认50，最大500
页码	page	否	GET/POST	页码，默认1
时间戳	t	否	GET/POST	如果开启了[时间差效验]需提交此项
数据签名	sign	否	GET/POST	如果开启了[数据签名]需提交此项

返回参数说明：

名称	类型	说明
code	Int	返回状态码 200为成功
appid	Int	应用ID
total	Int	该应用下用户总数
page	Int	当前页码
num	Int	每页数量
list	Array	用户列表数组，按UID倒序排列
uid	Int	用户UID
user	String	用户账号
name	String	用户昵称（名称）
qq	Int	用户QQ
status	String	用户状态正常/封禁
reg_time	String	用户注册时间
time	String	请求时间戳
check	String	数据校验码

返回示例：

{
    "code": 200,
    "msg": {
        "appid": 10010,
        "total": 2,
        "page": 1,
        "num": 50,
        "list": [
            {
                "uid": 1001,
                "user": "xiaoci",
                "name": "小辞",
                "qq": 123456789,
                "status": "正常",
                "reg_time": "2026-08-01 12:00:00"
            },
            {
                "uid": 1002,
                "user": "test001",
                "name": "测试用户",
                "qq": 987654321,
                "status": "正常",
                "reg_time": "2026-08-02 15:30:00"
            }
        ]
    },
    "time": 1723456789,
    "check": "00e837c144a02a5ed3717647ee3f33da"
}

错误码格式说明：

名称	类型	说明
101	String	应用不存在
102	String	应用已关闭
171	String	接口维护中
172	String	接口未添加或不存在
100	String	应用不存在或未开通该接口
104	String	签名为空
105	String	数据过期
106	String	签名有误

代码示例：

# Python 示例（纯明文对接，使用 api.php 接口地址）
import json
import urllib.request
import urllib.parse

API_URL = "https://xiaor2.wsff.cn/api.php"   # 官方文档接口地址（api.php 格式）
APPID   = 10010                               # 你的应用APPID

# 获取应用下的用户列表（按应用ID返回用户QQ、昵称等）
params = {"num": 50, "page": 1}
url = API_URL + "?" + urllib.parse.urlencode({"api": "userlist", "app": str(APPID)})
data = urllib.parse.urlencode(params).encode("utf-8")
req = urllib.request.Request(url, data=data)
with urllib.request.urlopen(req, timeout=30) as resp:
    result = json.loads(resp.read().decode("utf-8"))

print(result)
if result.get("code") == 200:
    msg = result["msg"]
    print("应用ID: %s, 用户总数: %s" % (msg["appid"], msg["total"]))
    for user in msg["list"]:
        print("UID: %s  账号: %s  昵称: %s  QQ: %s  状态: %s" % (
            user["uid"], user["user"], user["name"], user["qq"], user["status"]))