介绍

ZXAPI 是可以为用户提供消息分发、数据存储、任务队列、地球坐标和排行榜计算等功能在线接口(接口支持 HTTP 或 WebSocket 协议)。这些接口底层功能由 C++ 开发,通过 Google V8 引擎解析用户上传的 JavaScript 脚本进行调用。脚本上传后1秒内生效,可以不断线热更新。

接口特点:


举例示范

下面以排行榜功能举例示范,排行榜功能主要用于实时排行计算。设置数值能立即获取到该数值排行(10亿级数据能在1毫秒内完成)。

zx.排行设置(榜单id,项id,数值,[时间]);

新增或更新某项数值,即使数值不变也会刷新时间,如果不带时间参数则使用当前系统时间。 返回值 = [错误码,原值,原时间];

zx.排行删除(榜单id,[项id]);

删除榜单中的某项,如果不带项id参数则删除整个榜单。 返回值 = [错误码];如果id项不存在或删除数量为零,错误码为1

zx.排行读取(榜单id,项id,[读取选项]);

读取某项的数值或获取更多信息。 读取选项 = 0 或不设置: 返回值 = [错误码,数值]; 读取选项 = 1: 返回值 = [错误码,数值,排名,null]; 读取选项 = 2: 返回值 = [错误码,数值,null,时间]; 读取选项 > 2: 返回值 = [错误码,数值,排名,时间];

zx.排行设取(榜单id,项id,数值,[时间]);

新增或更新某项数值,并获取最新排行。 返回值 = [错误码,原值,原时间,现在的排行];

zx.排行计算(榜单id,数值);

计算一个数值(应当)所处的排行,此操作不改变或影响排行榜. 返回值 = [错误码,排行];

zx.排行项列取(榜单id,起始项id,数量);

按项目id的顺序列出榜单内的项目 返回[错误码,[id,值],[id,值]...];结果包含起始项,数量不大于10000; 如果需要反方向列取,数量可以设置为负数,结果包括起始项。

zx.排行值列取(榜单id,起始值,数量);

根据数值大小列取榜单项目,从起始值开始由小到大列取。

排行榜功能接口在线测试

脚本下载或上传路径("/test.js" 路径可修改,不存在的目录会自动创建)
  

脚本示例(修改上传后立即生效);
 

连接或发送地址(可以是 ws:// 协议,也可以是 http:// 协议)
  

发送内容
  

状态或返回内容

 


Copyright © 2019 zxapi.com All Rights Reserved
在线API 版权所有
备案号:
粤ICP备17070415号-1