API DOCS
对接文档
标准 HTTP 接口,官方 SDK 开箱即用,5 分钟完成集成。以下参数均由后台实时维护。
GET
获取应用配置
接口地址
http://lovetgm.com/api.php?api=ini&app={应用ID}
获取应用配置接口(免加密白名单)。返回应用版本号 version、更新地址 app_update_url、公告 app_gg、强更开关 app_update_must 等,供客户端启动时检查更新与展示公告。app 参数由 URL 携带。
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 应用ID | app | 是 | 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 携带。
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 应用ID | app | 是 | 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绑定与到期时间。
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 应用ID | app | 是 | 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 表判定设备归属。
解绑规则(卡密配置 tab):禁止解绑 ban_unbind(y 时仅绑定设备可解绑)、最多解绑次数 ks_unbind_num(超限返回201)、解绑扣时 ks_unbind_min(分,从卡密到期时间扣除)、设备换绑间隔 logon_check_t(小时,解绑后换新设备需等待)。
免费模式(pay_mode=n)禁止解绑。多设备模式按 token 表判定设备归属。
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 应用ID | app | 是 | 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 指定单文件。
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 应用ID | app | 是 | Int | 应用ID |
| 文件ID | id | 否 | 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 秒。
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 应用ID | app | 是 | 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。
应用配置联动(用户配置 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。
应用配置联动(用户配置 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 余额。
会员卡密(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 小时,一次性。
频率:同邮箱同应用 180 秒 1 条,每日 6 条上限(123)。
邮箱控制:smtp_state=n(关闭)时全场景返回121。
邮件经应用配置的 SMTP 通道发送(用户配置 tab 的邮箱控制段),未配置返回201。
场景校验:reg/bind 时邮箱已被占用返回115;seek/untie 时账号不存在返回122。验证码有效期 1 小时,一次性。
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
| 是 | 邮箱 | |
| 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。
找回成功后该账号全端 token 吊销,需用新密码重新登录。账号不存在122、账号禁用114。
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
| 是 | 账号邮箱 | |
| 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。
act=name 改昵称;act=pwd 改密码(校验旧密码113,成功后其他设备 token 全部吊销,当前设备保留);act=email 换绑邮箱(验证码发到新邮箱,一次性);act=unbind 设备解绑(清空机器码+吊销全部 token,所有设备需重新登录)。
token 失效127、账号禁用114。
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
| token | 是 | 登录状态码 |
| act | 是 | 操作:name昵称/pwd密码/email邮箱/unbind设备解绑 |
| name | act=name | 新昵称(URL编码) |
| old_pwd/new_pwd | act=pwd | 旧密码/新密码6-18位 |
| email/code | act=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。
免费模式(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。
应用配置联动(用户配置 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 需放入加密包内一并提交)