当前接口状态 · 正常

账号登录使用的一个心跳检测api

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

接口地址: https://yz.jilicun.com/api.php?api=userheartbeat

备用接口: https://yz1.jilicun.com/api.php?api=userheartbeat

海外接口: https://www.ban365.com/api.php?api=userheartbeat

返回格式: JSON

请求方式: GET/POST

请求示例: https://yz.jilicun.com/api.php?api=userheartbeat&app=10000 复制示例 跳转示例

请求参数说明:

名称 变量 必填 类型 说明
接口 api GET 填写 userheartbeat
应用 app GET 填写后台应用APPID
账号 user GET/POST 账号登录的用户名(与 userlogon 接口保持一致)
密码 password GET/POST 账号密码(与 userlogon 接口保持一致,用于心跳时再次验证账号密码)
时间戳 t GET/POST 如果开启了[时间差效验]需提交此项
数据签名 sign GET/POST 如果开启了[数据签名]需提交此项(算法与其他接口一致,详见Sign说明)

返回参数说明:

名称 类型 说明
code String 返回状态码,200 表示心跳成功,其它为错误码
msg Mixed 当 code!=200 时为错误提示字符串;
当 code=200 时为账号信息对象,主要字段:user(账号)、qq、name(昵称)、vip(VIP到期时间)、ban(账号到期时间)、ban_notice(封禁提示)、pic(头像地址)、fen(积分)、rmb(余额)、heartbeat_time(本次心跳时间)
time String 服务器当前时间戳,秒级,10 位
check String 二次效验值,与其他接口保持一致(算法说明见 Sign 说明)

返回示例:

// 心跳正常
{
    "code": 200,
    "msg": {
        "user": "test_user",
        "qq": "123456",
        "name": "测试用户",
        "vip": "2026-12-31 23:59:59",
        "ban": "2030-01-01 00:00:00",
        "ban_notice": "",
        "pic": "https://example.com/avatar.png",
        "fen": "100",
        "rmb": "10.00",
        "heartbeat_time": "2026-02-23 12:00:00"
    },
    "time": 1761200000,
    "check": "40c61b5c845ce218122a0e4309d6b72e"
}


// 心跳间隔超时(超过 heartbeat_timeout 秒) { "code": 153, "msg": "心跳间隔超时(超过300秒),连接已失效,请重新登录", "time": 1761200300, "check": "dc3b764154ec4e7977c3d451947b05d4" }
// 账号被封禁 { "code": 114, "msg": "账号已被封禁,请联系管理员", "time": 1761200400, "check": "a83e3b51d1b1c1633fcca53a9b220b03" }
// VIP 已到期 { "code": 175, "msg": "VIP已到期", "time": 1761200500, "check": "8562d8fd7d841b4271a9e420f0eb3a2c" }
// 账号已到期 { "code": 176, "msg": "账号已到期", "time": 1761200600, "check": "a58c19f1d60ab53a6e51dd41efff58b1" }
// 积分为 0(在应用开启积分校验时) { "code": 177, "msg": "积分为0", "time": 1761200700, "check": "00ec3bfa0b472ea190384891f5a0b6c0" }

错误码格式说明:

名称 类型 说明
101 String 应用不存在
102 String 应用已关闭
171 String 接口维护中
172 String 接口未添加或不存在
100 String 应用配置未加载
110 String 账号为空(user 未提交)
111 String 密码为空
113 String 账号或密码错误
114 String 账号被封禁,返回后台设置的封禁提示
122 String 账号不存在
153 String 心跳间隔超时,连接已失效,需要重新登录
175 String VIP 已到期
176 String 账号已到期
177 String 积分为 0(在应用开启积分校验时)

代码示例:

// 账号心跳请求示例(伪代码说明)
{
    // 接口地址:
    // https://你的域名/api.php?api=userheartbeat&app=应用ID
    //
    // 按账号心跳(与 userlogon 一致):
    // 提交参数:user=账号 & password=密码
    //
    // 如开启时间差效验:
    // 额外提交:t=当前时间戳
    //
    // 如开启数据签名:
    // 按照“将所有 POST 提交参数拼接后 + &APPKEY 取 MD5 值”的规则计算 sign,并一同提交
}

点我进群