分享一款GTAOL线上角色数据查询的API接口

2024-09-18 54 0

简介

本API接口由作者“空桑”开发提供,仅用于GTAOnline线上模式玩家角色数据信息查询,可用于对接QQ机器人,也可对接单独开发的应用程序。

温馨提示:对接此API接口请注明署名“数据来源于空桑的洛圣都Express”,谢谢合作。

站长对接制作成品展示

成品程序展示

分享一款GTAOL线上角色数据查询的API接口

API对接

获取玩家数据

路径:/api/status

请求方式:[GET]

参数

字段名数据类型默认值说明
nicknamestring-玩家昵称
limitnumber20最大数据请求记录

可能存在的非预期返回

错误代号错误代码原因
BadRequset400输入错误的昵称

如果不存在对应帐号的查询记录将不会返回数据。

响应数据[json]:

字段名数据类型默认值说明
昵称string-传入后经校验的昵称
Rockstar_IDnumber-R星ID(帐号身份证)
状态更新string-玩家状态更新时间
最近游玩string-最近游玩时间
简介string-玩家个人中心简介
当前帮会string-设置的当前活跃帮会名称
鲨鱼卡string-已在空桑处登记的鲨鱼卡记录证明
不计入收入string-黑钱(非正常来源或官方活动赠送的金币)
所在地string-翻译后的所在地
所在地代码string-所在地代码
所在帮会string-玩家加入的帮会记录
曾用昵称formerName-查询依据R星ID记录匹配
拥有游戏gameOwn-该玩家已购买Rockstar开发制作的相关游戏
绑定账户linkAccount-该玩家所绑定的Steam或Epic平台账户信息
数据记录record-查询数据的记录

响应示例[formerName]

["formername1", "formername2"]

响应示例[gameOwn]

[
  {
    "游戏昵称": "GTAV",
    "游戏平台": "PC",
    "上次游玩": "2019-1-1"
  }
]

响应示例[linkAccount]

[
  {
    "平台": "Steam",
    "昵称": "114514",
    "编号": "1919810"
  }
]

响应示例[record]

[
  {
    "索引": "114514",
    "时间": "2021-01-01 01:01:01",
    "状态": "可用",
    "代号": "200"
  }
]

获取玩家有效内最新数据

路径:/api/recent

请求方式:[GET]

参数

字段名数据类型默认值说明
nicknamestring-玩家昵称
expirenumber7200数据有效期(秒)
platformstring"default"游戏平台
typestring"index"数据返回类型

可能存在的非预期返回:

错误代号错误代码原因
BadRequset400输入了错误的昵称
SeeOther303无法查询到有效期内的数据

响应数据[json]:

type=index

{
  "索引": "114514",
  "时间": "2021-01-01 01:01:01",
  "状态": "可用",
  "代号": "200"
}

响应数据[string]:

type=text

昵称: xxxx
角色创建: 2024-01-01
帮会: 洛圣都居民网
等级: 1
在线时长: 1小时
... ...
平台: PC
规则版本: 3.0.0
索引: ACBDEF

响应数据[string]:

type=detail

比text更加详细的内容
对接提示

如果有效期内没有可有数据,那么会返回非 200 响应码

获取玩家数据快照

路径:/api/index

请求方式:[GET]

参数

字段名数据类型默认值说明
indexstring-数据快照索引
typestring"index"/"text"/"detail"返回数据类型

可能存在的非预期返回:

错误代号错误代码原因
BadRequset400输入了错误的索引

响应数据[json/text]:

响应数据[json/text]:

申请更新玩家数据快照

路径:/api/post

请求方式:[GET]

参数

字段名数据类型默认值说明
nicknamestring-玩家昵称
platformstring"default"游戏平台

可能存在的非预期返回:

错误代号错误代码原因
BadRequset400输入了错误的昵称
SeeOther303上一条数据未过最短有效期

获取玩家数据查询记录

路径:/api/history

请求方式:[GET]

参数

字段名数据类型默认值说明
nicknamestring-玩家昵称
offsetnumber0返回数据起点
limitnumber50最大返回数据量
typestring"text"/"json"返回类型

可能存在的非预期返回:

错误代号错误代码原因
BadRequset400输入了错误的昵称
InternalServerError500服务器数据处理出错

响应数据[json/text]:

字段名数据类型默认值说明
数据记录record-与玩家数据查询接口一致

响应示例[record]

type=json

[
  {
    "索引": "114514",
    "时间": "2021-01-01 01:01:01",
    "状态": "可用",
    "代号": "200"
  }
]

type=text

  索引: 1919810
  时间: 2021-01-01 01:01:01
  状态: 可用
  代号: 200

  索引: 114514
  时间: 2020-01-01 01:01:01
  状态: 可用
  代号: 200

API接口对接例子

API请求地址:https://hqshi.cn/

地址+路径+参数A=值A+参数B=值B
路径=“/foo/bar”
参数A=“a”
值A=“y”
参数B=“b”
值B=“x”
#最终结果:[GET] https://hqshi.cn/foo/bar?a=y&b=x

举例:https://hqshi.cn/api/status?nickname=YUHANY06 (最后的“YUHANY06”是一位玩家的游戏ID)

查询结果

{"code": 200, "payload": true, "message": "请求成功", "body": {"昵称": "yuhany06", "名称": "YUHANY06", "玩家标识": "NETKXF", "rockstar_id": 187777753, "状态更新": "2022-08-11 11:26:26", "最近游玩": "GTAV | PC", "简介": null, "当前帮会": "IGN Crew", "鲨鱼卡": null, "不计入统计收入": null, "所在地": "中国", "所在地代码": "CN", "所在帮会": null, "曾用昵称": null, "拥有游戏": [{"游戏名称": "GTAV", "游戏平台": "PC", "上次游玩": "2024-04-24"}, {"游戏名称": "RDR2", "游戏平台": "PC", "上次游玩": "2024-04-20"}], "绑定账户": null, "备注": null, "数据记录": [{"索引": "FPY2P7", "时间": "2024-05-23 10:12:15", "状态": "可用", "代号": 200}, {"索引": "A6AJWB", "时间": "2022-09-07 15:03:25", "状态": "可用", "代号": 200}, {"索引": "BKAWCG", "时间": "2022-08-11 11:26:25", "状态": "可用", "代号": 200}]}}
分享一款GTAOL线上角色数据查询的API接口

以上截图便是请求API查询的最终结果,具体如何设计程序由您来完成,我只负责分享接口和例子。

目前我所知对接了此API的成品程序只有我自己做的盒子里面加了这个查询,原本我是有想过做Q群机器人的,但又觉得Q群机器人给群友玩纯属就是闲着无聊乱刷屏,所以也就没有做,如果你需要也可以拿去对接个机器人玩玩。

接口分享:木果资源分享博客

接口来源:洛圣都Express(空桑提供)

来源链接:https://hqshi.cn/wiki#/

友情提示:作者制作不易,一定要给作者加上来源署名。

    相关文章

    分享一个简单的辅助官网html源码
    荔枝自动发卡平台源码-异次元发卡系统
    端游/手游传奇官网客户端下载页html代码
    XyPlayer-v4.0影视解析源码

    发布评论