检测服务中…

光遇身高查询接口

用好友码查询国服、国际服身高。开发接入带令牌即可,网页版使用卡密。

GET STARTED

如何接入

准备一枚 API 令牌,按下面三步调用。

1

获取令牌

登录管理后台创建 API 令牌,调用时放在请求头 X-API-Key。

2

发起查询

向 /api/v1/query 提交好友码,成功会返回 task_id。

3

读取结果

用 GET /api/v1/task/{id} 查询任务,直到完成。

CAPABILITIES

能做什么

国服、国际服查询,以及礼包、网页卡密。

QUERY

国服身高

好友码查询,适合 App、脚本和联调。

INTL

国际服

路径与鉴权和国服一致,单独走国际服接口。

GIFT

礼包 / 解屏蔽

查询礼包购买情况,或取消屏蔽并删除。

WEB

卡密网页版

不方便带请求头时,使用卡密和 PoW。

REFERENCE

接口一览

查询、任务、健康检查都需要令牌。

方法路径用途鉴权
POST/api/v1/query国服身高查询令牌
POST/api/v1/intl/query国际服查询令牌
POST/api/v1/gifts礼包购买情况令牌
POST/api/v1/unblock取消屏蔽并删除令牌
GET/api/v1/task/{id}查询异步任务令牌
GET/api/v1/health健康检查令牌
GET/web/v1/pow/challenge网页版 PoW
POST/web/v1/query网页版国服查询卡密 + PoW

        
FAQ

常见问题

接入时这几条最常被问到。

打开网站怎么不是查询结果?

首页是说明。请调用 POST /api/v1/query,不要请求根路径。

返回 401 API_KEY_MISSING?

在请求头加上 X-API-Key。没有令牌可在管理后台创建。

提交后没有立刻返回身高?

查询是异步的。先拿到 task_id,再轮询 GET /api/v1/task/{id},建议超时不少于 60 秒。

网页版和 API 有什么区别?

API 给程序用,靠令牌。网页版走 /web/v1,需要卡密,并先请求 PoW。