API DOCS

对接文档

标准 HTTP 接口,官方 SDK 开箱即用,5 分钟完成集成。以下参数均由后台实时维护。

🌐 http://lovetgm.com/api.php 17 个接口 实时数据
GET

获取应用配置

接口地址 http://lovetgm.com/api.php?api=ini&app={应用ID}
获取应用配置接口(免加密白名单)。返回应用版本号 version、更新地址 app_update_url、公告 app_gg、强更开关 app_update_must 等,供客户端启动时检查更新与展示公告。app 参数由 URL 携带。
请求参数
字段名变量名必填类型说明
应用IDapp是Int应用ID
随机值value否String随机字符串
返回示例
{"code":200,"msg":{"version":"1.0","version_info":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","app_update_show":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","app_update_url":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","app_update_must":"n","api_total":"88"},"time":1700000000,"check":"md5(time+secretkey+value)"}
GET

获取应用公告

接口地址 http://lovetgm.com/api.php?api=notice&app={应用ID}
获取应用公告接口(免加密白名单)。返回当前应用设置的公告内容(应用配置 tab 的应用公告字段),无公告时返回空。app 参数由 URL 携带。
请求参数
字段名变量名必填类型说明
应用IDapp是Int应用ID
返回示例
{"code":200,"msg":{"app_gg":"这里是应用公告内容"},"time":1700000000,"check":"md5(time+secretkey+value)"}
POST

卡密登录

接口地址 http://lovetgm.com/api.php?api=kmlogon&app={应用ID}
卡密登录验证。免费模式下任意卡密返回永久会员;付费模式下校验卡密有效性、设备绑定、IP绑定与到期时间。
请求参数
字段名变量名必填类型说明
应用IDapp是Int应用ID
卡密kami是String卡密字符串
机器码markcode是String设备唯一标识
数据签名sign否String开启签名时必填
返回示例
{"code":200,"msg":{"kami":"XXXX-XXXX","vip":"1735689600"},"time":1700000000,"check":"md5(time+secretkey+value)"}

响应头(仅签名验证=both时返回):X-JG-Sign = MD5(响应体原文+SecretKey),用于客户端校验响应是否被篡改,详见「Sign签名计算方式」。
POST

卡密解绑

接口地址 http://lovetgm.com/api.php?api=kmunmachine&app={应用ID}
卡密解绑接口(设备解绑)。校验设备归属后清除绑定,允许换设备。
解绑规则(卡密配置 tab):禁止解绑 ban_unbind(y 时仅绑定设备可解绑)、最多解绑次数 ks_unbind_num(超限返回201)、解绑扣时 ks_unbind_min(分,从卡密到期时间扣除)、设备换绑间隔 logon_check_t(小时,解绑后换新设备需等待)。
免费模式(pay_mode=n)禁止解绑。多设备模式按 token 表判定设备归属。
请求参数
字段名变量名必填类型说明
应用IDapp是Int应用ID
卡密kami是String卡密字符串
机器码markcode是String原绑定设备标识
返回示例
{"code":200,"msg":"卡密解绑成功","time":1700000000,"check":"md5(time+secretkey+value)"}
GET

获取应用文件

接口地址 http://lovetgm.com/api.php?api=getfile&app={应用ID}
获取应用文件列表接口(免加密白名单)。返回应用发布的文件外链(含蓝奏云/网盘直链解析),无文件返回 201。app 参数由 URL 携带,可选 id 指定单文件。
请求参数
字段名变量名必填类型说明
应用IDapp是Int应用ID
文件IDid否Int不传则返回全部
返回示例
{"code":200,"msg":[{"file_url":"https://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","date":"2026-08-01 12:00:00","note":"备注"}],"time":1700000000,"check":"md5(time+secretkey+value)"}
POST

心跳验证

接口地址 http://lovetgm.com/api.php?api=kmheartbeat&app={应用ID}
客户端登录成功后,需定期调用此接口维持在线状态。登录状态码有效期由后台「登录状态码有效期」配置控制,默认 3600 秒。
请求参数
字段名变量名必填类型说明
应用IDapp是Int应用ID
卡密kami是String卡密字符串
登录状态码token是String登录成功后返回的 token(也可用 statecode 字段名)
机器码markcode是String登录时使用的机器码;多设备在线开启时必须与登录一致(旧客户端可省略)
数据签名sign否String开启签名时必填
返回示例
{"code":200,"msg":"心跳验证成功","time":1700000000,"check":"md5(time+secretkey+value)"}
POST

子用户注册

接口地址 http://lovetgm.com/api.php?api=userreg&app={应用ID}
子用户注册接口。
应用配置联动(用户配置 tab):注册开关 reg_state(关闭返回103+提示文案);IP重复注册间隔 reg_ipon(小时,默认24);设备重复注册间隔 reg_inon(小时,0=不限);注册奖励 reg_award+reg_award_num(vip按分钟/fen积分,0不奖励,即时落入新用户);邀请奖励 inv_award+inv_award_num(vip按小时/fen积分,受邀人注册时结算给邀请人)。
频率:同IP 24小时、同设备按 reg_inon 间隔限制,超限返回117。
请求参数
参数必填说明
app是应用ID(URL参数)
user是账号3-16位字母数字下划线
password是密码6-18位,支持字母数字 .*_-
name否昵称(支持中文,URL编码传输)
markcode视配置机器码;开启设备注册间隔(reg_inon)后必填
inv否邀请人子用户ID
返回示例
{"code":200,"msg":"注册成功","time":1700000000,"check":"md5(time+secretkey+value)"}
POST

子用户登录

接口地址 http://lovetgm.com/api.php?api=userlogon&app={应用ID}
子用户登录接口。
应用配置联动(用户配置 tab):登录开关 logon_state(关闭返回103+提示文案);登录方式 logon_way(1=卡密登录模式时账号登录返回163,走 kmlogon);登录验证设备 logon_check_in(y 时必须携带 markcode,否则112);多设备登录数 logon_num(0或1=单设备;多设备超上限时按设备换绑间隔 logon_check_t 校验后踢最旧设备,间隔内返回201+剩余时间)。
token 为后续登录态接口凭证。免费模式(pay_mode=n)vip 恒为 4102243200。
请求参数
参数必填说明
app是应用ID(URL参数)
account是账号/邮箱/手机号(兼容旧字段 user)
password是密码
markcode视配置机器码;开启登录验证设备(logon_check_in)后必填
返回示例
{"code":200,"msg":{"token":"8aFv42Ev52NvuAA2V5A42NN82855vOaV9pAZ1Wma","info":{"id":1,"user":"demo","name":"演示用户","vip":"1735689600","fen":0}},"time":1700000000,"check":"md5(time+secretkey+value)"}
POST

子用户心跳验证

接口地址 http://lovetgm.com/api.php?api=userheartbeat&app={应用ID}
子用户心跳验证。每次心跳刷新在线时间与 last_t,返回最新 vip/fen 余额。token 失效返回 127(应重新登录)。建议客户端 30-60 秒一次。
请求参数
参数名必填说明
token是登录返回的 token(也兼容 statecode 字段名)
markcode否机器码/设备码
返回示例
{"code":200,"msg":{"vip":"1735689600","fen":0},"time":1700000000,"check":"md5(time+secretkey+value)"}
POST

子用户信息查询

接口地址 http://lovetgm.com/api.php?api=getinfo&app={应用ID}
获取子用户全量信息:id/user/name/email/phone/vip/fen/inv/reg_time/markcode/last_time。免费模式(pay_mode=n)vip 恒为 4102243200。每次调用刷新 last_t。
请求参数
参数名必填说明
token二选一登录返回的 token
account二选一账号/邮箱/手机号(需配合 password)
password选account时必填密码
返回示例
{"code":200,"msg":{"id":1,"user":"账号","name":"昵称","email":"","phone":"","vip":"0","fen":0,"reg_time":0,"last_time":0},"time":1700000000,"check":"md5(time+secretkey+value)"}
POST

卡密充值(会员/积分)

接口地址 http://lovetgm.com/api.php?api=card&app={应用ID}
卡密兑换接口:给子用户账号充值。
会员卡密(type=vip):amount 为天数,账号 vip 到期时间累加(未过期叠加、已过期从当前起算);已是永久会员(999999999)返回 199。
积分卡密(type=fen):amount 为积分数,账号 fen 累加。
充值对象三选一:account(账号/邮箱/手机号)、token(登录态)、mainkm(主卡密同类型叠加续费)。
时长卡(code)/次数卡(single) 不走此接口,返回201引导走 kmlogon 直登模式。成功返回最新 vip/fen 余额。
请求参数
参数名必填说明
kami是卡密字符串
account三选一子用户账号
token三选一子用户登录 token
mainkm三选一主卡密(同类型叠加)
返回示例
{"code":200,"msg":{"vip":"1735689600","fen":100},"time":1700000000,"check":"md5(time+secretkey+value)"}
POST

GET验证码

接口地址 http://lovetgm.com/api.php?api=sendcode&app={应用ID}
子用户邮箱验证码。
频率:同邮箱同应用 180 秒 1 条,每日 6 条上限(123)。
邮箱控制:smtp_state=n(关闭)时全场景返回121。
邮件经应用配置的 SMTP 通道发送(用户配置 tab 的邮箱控制段),未配置返回201。
场景校验:reg/bind 时邮箱已被占用返回115;seek/untie 时账号不存在返回122。验证码有效期 1 小时,一次性。
请求参数
参数必填说明
email是邮箱
type否场景:reg注册验证/seek找回密码/bind绑定新邮箱/untie解绑邮箱
返回示例
{"code":200,"msg":"发送成功","time":1700000000,"check":"md5(time+secretkey+value)"}
POST

找回密码

接口地址 http://lovetgm.com/api.php?api=seekpass&app={应用ID}
找回密码。验证码一次性(用后即焚),有效期 1 小时(124)。
找回成功后该账号全端 token 吊销,需用新密码重新登录。账号不存在122、账号禁用114。
请求参数
参数必填说明
email是账号邮箱
code是验证码(sendcode type=seek 获取)
newpassword是新密码6-18位
返回示例
{"code":200,"msg":"找回成功","time":1700000000,"check":"md5(time+secretkey+value)"}
POST

修改用户资料

接口地址 http://lovetgm.com/api.php?api=useredit&app={应用ID}
修改用户资料(多功能合一,token 鉴权)。
act=name 改昵称;act=pwd 改密码(校验旧密码113,成功后其他设备 token 全部吊销,当前设备保留);act=email 换绑邮箱(验证码发到新邮箱,一次性);act=unbind 设备解绑(清空机器码+吊销全部 token,所有设备需重新登录)。
token 失效127、账号禁用114。
请求参数
参数必填说明
token是登录状态码
act是操作:name昵称/pwd密码/email邮箱/unbind设备解绑
nameact=name新昵称(URL编码)
old_pwd/new_pwdact=pwd旧密码/新密码6-18位
email/codeact=email新邮箱+验证码(sendcode type=bind 发到新邮箱)
返回示例
{"code":200,"msg":"昵称已更新","time":1700000000,"check":"md5(time+secretkey+value)"}
POST

获取用户信息

接口地址 http://lovetgm.com/api.php?api=userinfo&app={应用ID}
获取子用户全量信息:id/user/name/email/phone/vip/fen/inv/reg_time/markcode/last_time。
免费模式(pay_mode=n)vip 恒为 4102243200。每次调用刷新 last_t。token 失效127。
请求参数
参数必填说明
token是登录状态码
返回示例
{"code":200,"msg":{"id":1,"user":"xx","name":"xx","email":"","phone":"","vip":"1735689600","fen":0,"inv":0,"reg_time":1700000000,"markcode":"","last_time":1700000000},"time":1700000000,"check":"md5(time+secretkey+value)"}
POST

用户签到

接口地址 http://lovetgm.com/api.php?api=userdiary&app={应用ID}
子用户签到。
应用配置联动(用户配置 tab 登录控制段):签到奖励 diary_award(vip按分钟/fen积分)+ diary_award_num(0=不奖励返回146)。
当日已签返回147;永久会员(999999999)不可再签199。
会员奖励:未过期叠加、已过期从当前起算;积分奖励:直接累加。成功返回最新 vip/fen。
请求参数
参数必填说明
token是登录状态码
返回示例
{"code":200,"msg":{"vip":"1735689600","fen":0,"msg":"签到成功,会员 +30分钟"},"time":1700000000,"check":"md5(time+secretkey+value)"}
GET

Sign签名计算方式

所有接口的 POST 参数(除 sign 外)按 key=value 用 & 连接,最后拼上 SecretKey(即应用配置中的通信密钥 secretkey),再取 MD5 值即为 sign。签名开关开启时需携带该参数。 【双向签名校验(sign_switch=both 专属)】 当应用的签名验证选择 both(双向)时,服务端会对每个响应额外计算响应签名,并通过 HTTP 响应头返回: 头名称:X-JG-Sign 计算方式:MD5(响应体原文 + SecretKey) 说明:响应体原文即客户端收到的完整响应内容(若开启了返回加密,则为加密后的密文)。 客户端收到响应后,用同样的 SecretKey 对响应体原文计算 MD5,与 X-JG-Sign 比对:一致则响应未被篡改;不一致说明响应被篡改或服务端非官方,应丢弃。 注意:该头仅在签名验证=both 时返回;request 模式下不返回,客户端无需校验。ini/notice/getfile 接口不参与双向签名。 作用:防止抓包篡改响应内容(如修改到期时间 msg.vip、伪造返回码)。check 字段仅绑定 time 与 value,不绑定业务字段,双向签名正是为覆盖这一场景。
请求参数
字段名变量名必填类型说明
数据签名sign否String开启签名时必填,值为 MD5
返回示例
Sign = 取MD5值( 按提交顺序拼接的「字段名=值&...」 + SecretKey )

注意:签名串中不包含 sign 本身,也不包含 value、app、api 等非业务字段;SecretKey 只拼接一次,串中间没有任何固定值。

示例(卡密登录,假设 SecretKey = TESTSECRETKEY):
  提交参数:kami=TGM2026&markcode=ABC123DEF&t=1790000000
  签名串  :kami=TGM2026&markcode=ABC123DEF&t=1790000000&TESTSECRETKEY
  Sign     :91dc419f59d69265dfdef54d92142861

(以上为本平台实测值,对接时可按此格式重放验证;若应用开启了 data 加密,sign 需放入加密包内一并提交)