跳至主要內容

TASA-Ed RUST-API

TASA-Ed工作室...大约 7 分钟约 2219 字

重要

近期 api.tasaed.top 已经切换到了 rust 写的 api 上，可能会有问题，如果你遇到请及时反馈，文档正在撰写中。

TASA-Ed 工作室提供的 RUST-API

返回格式

各 API 返回格式基本一致，若有特殊情况则会在 返回 中标明。

文本格式

  • 直接返回结果。

  • 错误时返回：

Error:

<错误类型> ;

Data:

<错误描述> ;

Success:

false ;

json 格式

  • 成功时返回：
{
  "success":true,
  "data":"<结果>"
}
  • 错误时返回：
{
  "success":false,
  "error":"<错误类型>",
  "data":"<错误描述>"
}

xml 格式

  • 成功时返回：
<?xml version="1.0" encoding="UTF-8"?>
<api>
  <success>true</success>
  <data>结果</data>
</api>
  • 错误时返回：
<?xml version="1.0" encoding="UTF-8"?>
<api>
  <success>false</success>
  <error>错误类型</error>
  <data>错误描述</data>
</api>

API 相关

可用性查询

查询当前可用性。

GET https://api.tasaed.top/
###
GET https://api.tasaed.top/status

在使用之前，请先请求以确保API可用性。

参数

  • format:
    • text(默认):输出文本格式。
    • json:输出 json 格式。
    • xml:输出 xml 格式。

返回

仅返回 success 。

时间相关

时间获取

获取时间。

GET https://api.tasaed.top/time/

参数

  • format:
    • text(默认):输出文本格式。
    • json:输出 json 格式。
    • xml:输出 xml 格式。
  • type:
    • 1 为中国时区。
    • 2 为时间戳。
    • 3 为格林威治时间。
    • 4 为协调世界时。
    • 5 为上海时间。
    • 6 为纽约时间。
    • 7 为新加坡时间。
    • 8 为乌鲁木齐时间。
    • 9 为毫秒时间戳。
    • 10 为自主输入时区，参考 IANA 时区列表。
  • timezone: 为 IANA 时区，只在 type=10 时有效。

返回

data 在返回时间戳时为 int 类型。

示例

文本处理

哈希

哈希值计算。推荐使用此API。

GET https://api.tasaed.top/hash/

参数

  • format:
    • text(默认):输出文本格式。
    • json:输出 json 格式。
    • xml:输出 xml 格式。
  • content: 内容。
  • type: 可为：
    • md2
    • md4
    • md5|md
    • sha1
    • sha224
    • sha256|sha|sha2
    • sha384
    • sha512
    • sha3-224
    • sha3-256|sha3
    • sha3-384
    • sha3-512
    • sm3
    • ripemd160|ripemd
    • ripemd256
    • ripemd320
    • whirlpool
    • xxh3|xxh3-64
    • xxh3-128
    • crc32
    • crc32b
    • crc32c
    • gost
    • gostcrypto|gost-crypto
    • murmur3a|murmur3-32
    • murmur3f|murmur3-64
    • fsb256|fsb
    • fsb384
    • fsb512
    • streebog256|streebog
    • streebog512
    • groestl224|groestl
    • groestl256
    • groestl384
    • groestl512
  • binary: 为 1 时输出 Base64 格式。

注意

需要注意的是，binary 为 1 时我们会将哈希的二进制格式转为 Base64 。

示例

Base64

Base64编码或解码。

GET https://api.tasaed.top/base/
###
GET https://api.tasaed.top/base64/

参数

  • format:
    • text(默认):输出文本格式。
    • json:输出 json 格式。
    • xml:输出 xml 格式。
  • value: 内容。
  • type:
    • 0 为 Base64 标准编码。
    • 1 为 Base64 容忍填充错误解码。
    • 2 为 Base64 URL_SAFE 编码。
    • 3 为 Base64 URL_SAFE 解码。
    • 4 为 Base64 标准解码。

示例

生成相关

随机数生成

生成一个随机数。

GET https://api.tasaed.top/rand/
###
GET https://api.tasaed.top/random/

参数

  • format:
    • text(默认):输出文本格式。
    • json:输出 json 格式。
    • xml:输出 xml 格式。
  • min: 最小数。
  • max: 最大数。
  • type:
    • 1 为使用默认 ThreadRng 生成器。
    • 2 为使用 ChaCha20 生成器。
    • 3 为使用 Xoshiro256++ 生成器。
    • 4 为使用随机浮点数生成器，保留 6 位小数。
    • 不指定或指定错误将默认使用 ThreadRng 生成器。

返回

成功时 data 返回 int 类型，type 为 4 返回 float 类型。

示例

生成 ULID

生成通用唯一按字典排序的标识符（ULID）。

GET https://api.tasaed.top/ulid/

参数

  • format:
    • text(默认):输出文本格式。
    • json:输出 json 格式。
    • xml:输出 xml 格式。
  • type:
    • 1 为指定一个时间戳生成。
  • timestamp: 时间戳，请填写UNIX毫秒级时间戳。

示例

RGB与16进制互转

RGB与16进制互转。

GET https://api.tasaed.top/color/h2r/

参数

  • format:
    • text(默认):输出文本格式。
    • json:输出 json 格式。
    • xml:输出 xml 格式。
  • type: 为 1 时是16进制转RGB，为 2 是RGB转16进制。
  • hex: 16进制颜色代码，只在 type 为 1 时有效。
  • rgb: RGB颜色代码，用英文逗号 , 分割，只在 type 为 2 时有效。

返回

type 为 1 时返回一个数组，为 2 时返回一个字符串。

示例

句子转拼音

将任意中文转为拼音。

GET https://api.tasaed.top/pinyin/

参数

  • format:
    • text(默认):输出文本格式。
    • json:输出 json 格式。
    • xml:输出 xml 格式。
  • type: 为转拼音类型。
    • 1 : 普通句子转拼音。
    • 2 : 在转为拼音的同时保留所有非汉字字符。
    • 3 : 将首字作为姓氏转换。
    • 4 : 转换为用于链接的拼音字符串。
    • 5 : 转换为只保留首字符的字符串。
    • 6 : 转换为只保留首字符字符串的同时保留原字符串的英文单词。
    • 7 : 转换为姓名首字母的字符串。
  • content: 内容。
  • join: 为连接拼音的字符串，不填写则为空字符串，填写sp将会转为空格。
  • tonestyle: 为拼音样式。
    • symbol : （默认）声调符号，例如 pīn yīn。
    • none : 不输出拼音，例如 pin yin。
    • number : 末尾数字模式的拼音，例如 pin1 yin1。

示例

Steam ID

Steam ID 64 与 Steam ID 3 互转。

GET https://api.tasaed.top/get/steamid/

参数

  • format:
    • text(默认):输出文本格式。
    • json:输出 json 格式。
    • xml:输出 xml 格式。
  • type: 为转拼音类型。
    • 1 : Steam ID 64 转 Steam ID 3。
    • 2 : （默认）Steam ID 3 转 Steam ID 64。
  • id: Steam ID。

示例

获取相关

获取 IP

获取您当前的IP。支持 IPv6。

GET https://api.tasaed.top/ip/

参数

  • format:
    • text(默认):输出文本格式。
    • json:输出 json 格式。
    • xml:输出 xml 格式。

示例

获取 UA

获取浏览器当前的UA。

GET https://api.tasaed.top/ua/

参数

  • format:
    • text(默认):输出文本格式。
    • json:输出 json 格式。
    • xml:输出 xml 格式。
  • type: 为 1 时输出不转义斜杠的UA，只在输出json格式时有效。

示例

获取必应壁纸链接

获取今日的必应壁纸链接。

GET https://api.tasaed.top/get/bingtoday/

参数

  • format:
    • jump(默认):跳转到链接。
    • text:输出文本格式。
    • json:输出 json 格式。
    • xml:输出 xml 格式。
  • type: 为壁纸分辨率。
    • f : 为 1920x1080。
    • m : 为 1080x1920。
    • hd : 为 1280x720。
    • hdm : 为 720x1280。
    • uhd : 为 3840x2160。
  • unescape: 为 1 时输出不转义斜杠的UA，只在输出json格式时有效。

返回

jump 格式时会返回一个 301 重定向。

示例

获取 MC 服务器信息

获取 Minecraft 服务器信息。仅支持 Java 1.7+。

GET https://api.tasaed.top/get/minecraftServer/
###
GET https://api.tasaed.top/get/minecraft-server/
###
GET https://api.tasaed.top/get/mc-server/
###
GET https://api.tasaed.top/get/mcServer/

参数

  • hostname: 服务器 IP 或域名
  • port: 服务器端口

返回

成功时返回：

{
  "players": "0/0", // <在线人数>/<最大人数>
  "text": "", // 服务器描述
  "version": "1.20.1", // 服务器版本
  "protocol": 0, // 协议版本
  "list": [], // ["<玩家名称>"]
  "success": true
}

错误时返回：

{
  "data": "错误描述",
  "success": false
}

获取起源游戏服务器信息

使用 A2S 协议获取起源游戏服务器信息。

GET https://api.tasaed.top/get/a2sServer/
###
GET https://api.tasaed.top/get/a2s-server/
###
GET https://api.tasaed.top/get/sl-server/
###
GET https://api.tasaed.top/get/slServer/

警告

在中国，有相当一部分起源游戏服务器屏蔽了海外 UDP 请求，因此你可能无法获取到任何信息，只会返回 {"data":"Failed to read any data from socket","success":false} 。

参数

  • hostname: 服务器 IP 或域名
  • port: 服务器端口

返回

成功时返回：

{
  "protocol": 0, // 协议版本
  "title": "", // 服务器标题
  "map": "", // 服务器地图
  "game": "", // 服务器游戏
  "players": "0/0", // <在线人数>/<最大人数>
  "bots": 0, // 机器人
  "server_os": "Windows", // 服务器系统
  "visibility": false, // 可见性
  "vac": false, // VAC
  "version": "", // 服务器版本
  "port": 0, // 端口（可能不存在）
  "game_id": "", // 游戏 ID（可能不存在）
  "success": true
}

错误时返回：

{
  "data": "错误描述",
  "success": false
}

其他

无。

最近更新:
贡献者: ccd2s