简介

此文档用于详细描述本站开放的API使用方式。

此文档仍在编辑中。

提示:PC端可通过侧边的大纲快速定位

部分项目因服务器(CPU,内存,磁盘,流量等)开销较大,必要时可能会关闭相关API服务

开放的域名:

域名强制SSL描述
xiwangly.top主域名,一些专用的API保存在此
api.xiwangly.top最常用,日后的API都将开放于此
e52.top备用

API列表

目前默认输出都是纯文本(TEXT)格式(主要是为了适配多数QQ机器人程序),后续开放XML和JSON类型的输出。

Imagettftext

请求地址:

https://api.xiwangly.top/imagettftext/index.php

请求方式:GET/POST

参数名称必填类型默认值取值范围【正则表达式】描述
image否*Stringwhite.png(./images/white.png)本地图像(如果imageurl不为空,则此项无效)
imageurl否*String远程图像
rInt00-255颜色R
gInt00-255颜色G
bInt00-255颜色B
sizeFloat30>0字体大小
iFloat0字体倾斜的角度
xInt10起始文字的x坐标
yInt40起始文字的y坐标
fontStringarialuni.ttf(./fonts/arialuni.ttf)字体文件
textString文本
注:image和imageurl参数有且仅有一个必填

请求示例:https://api.xiwangly.top/imagettftext/?image=&imageurl=&r=&g=&b=&size=&i=&x=&y=&font=&text=文本

返回格式:Images

开源地址: imagettftext

图形化的imagettftext:https://api.xiwangly.top/imagettftext/get.html

感谢@mufeng233的美化版imagettftext:https://api.muxiuge.cn/imagetext

短网址

请求地址:

请求方式:GET

参数名称必填类型默认值取值范围【正则表达式】描述
urlString【[a-zA-z]+://[^\s]*】网址

请求示例:

返回格式:TEXT

开源地址:dwz_php

Math

请求地址:https://api.xiwangly.top/math.php

请求方式:GET/POST

参数名称必填类型默认值描述
xStringx的值
yStringy的值
zStringz的值
mStringm的值

请求示例:https://api.xiwangly.top/math.php?x=2&y=3&z=&m=a

返回格式:TEXT

如果只需要1个值参与运算,请保留x的值;如果只需要2个值参与运算,请保留x和y的值;以此类推。在下表的备注中(number)即需要提交的变量数(不包含m的值)。值的大小写是敏感的。

名称m的值备注
加(x+y)a(2)
减(x-y)s(2)
乘(x*y)m(2)
除(x/y)d(2)
余(x%y)r(2)
并置(x.y)ss(2|3)合并字符串
幂(x^y)pow(2)
绝对值(|x|)abs(1)
反余弦acos(1)
反双曲余弦acosh(1)
反正弦asin(1)
反双曲正弦asinh(1)
反正切atan(1)
两个变量的反正切atan2(2)
反双曲正切atanh(1)
进制转换base(3)x为待转换值,y为原进制,z为要转换的进制,不支持浮点和负数
二进制转十进制bindec(1)
向上舍整ceil(1)向上舍入最接近的整数
余弦cos(1)
双曲余弦cosh(1)
十进制转二进制decbin(1)
十进制转十六进制dechex(1)等价于$HexEncoder %括号1%$
十进制转八进制decoct(1)
角度值转弧度值deg2rad(1)
E^xexp(1)
E^x-1expm1(1)
向下取整floor(1)向下舍入最接近的整数
模(x/y的余数)fmod(2)
x至最大值getrandmax(1)x-getrangmax的最大值
十六进制转十进制hexdec(1)等价于$HexDecoder %括号1%$
直角三角形的斜边值(x^2+y^2)hypot(2)
判断是否为有限值finite(1)返回值为"1"或null
判断是否为无限值infinite(1)返回值为"1"或null
判断是否为非数值nan(1)返回值为"1"或null
0-1伪随机数lcg(1|2|3)x|y|z可以定义任何值
对数log(1|2)如果y为null,则输出以e为底的对数(自然对数)
以10为底的对数log10(1)
对数1+xlog1p(1)
最大值max(2|3)输出x,y(,z)中的最大值
最小值min(2|3)输出x,y(,z)中的最小值
x至最大值mtgetrandmax(1)x-mt_getrangmax的最大值
随机整数mtrand(2)使用Mersenne Twister算法生成随机整数
播种随机数mtsrand(1)播种Mersenne Twister随机数生成器
八进制转十进制octdec(1)
πpi(1|2|3)x|y|z可以定义任何值,输出圆周率π的值
弧度值转角度值rad2deg(1)
随机整数rand(2)比上表的mtrand更慢
浮点数四舍五入round(1)
正弦sin(1)
双曲正弦sinh(1)
平方根sqrt(1)
播种随机数srand(1)播种随机数生成器
正切tan(1)
双曲正切tanh(1)
递增aa(1)
递减rr(1)
测试打印变量echox,echoy,echoz(1)m允许的值3选1
常数ee(1|2|3)x|y|z可以定义任何值,输出常数e
Euler常量euler(1|2|3)x|y|z可以定义任何值,输出Euler常量
URLurl(1)跳转外链
时间戳time(1|2|3)x|y|z可以定义任何值
日期date(1)x允许的值见(点我跳转)
MD5md5(1|2)y允许的值有"true"(输出16字符)或null(输出32字符)
生成唯一IDuniqid(1|2)x规定生成前缀(可为空),y允许的值有"true"(输出23字符)或除"true"外任何值(输出13字符)
随机布尔值tf(1|2|3)x|y|z可以定义任何值
文件MD5md5file(1)支持多协议,不允许大文件或木马传入
base64加密base64encode(1)
base64解密base64decode(1)
逻辑与and,andand(2)m允许的值2选1
逻辑或or,oror(2)m允许的值2选1
逻辑异或xor(2)
逻辑非(不等于)not(2)
等于equal(2)
不等于lessgreater(2)
大于greater(2)
小于less(2)
大于等于greaterequal(2)
小于等于lessequal(2)
圆的面积areaacircle(1)x为半径
获取浮点值floatval,doubieval(1)m允许的值2选1
获取整数值intval(1)
获取布尔值boolval(1)
判断是否为空值empty(1)
uuencode 编码uuencode(1)
uuencode 解码uudecode(1)
带有函数的字符串fx(1)
判断数字大小cmp(2)x<y返回"(1)",x=y返回"0",x>y返回"1"
正则表达式判断preg(2)x为正则表达式,y为待匹配内容
ASCII字符转十六进制bin2hex(1)
把数据装入一个二进制字符串pack(2)与bin2hex相反,x为包装数据时所使用的格式,y为内容
从指定的 ASCII 值返回字符chr(1)
单向字符串加密(hashing)crypt(1|2)x为要编码的字符串,y规定增加被编码字符数目的字符串
计算字符串32位CRCcrc32(1)
反向显示希伯来字符hebrev(1|2)
反向显示希伯来字符hebrevc(1|2)反向显示希伯来字符,并把新行(\n)转换为<br>,y规定每行的最大字符数

开源地址:math-API

一言

请求地址:https://api.xiwangly.top/yiyan.php

请求方式:GET/POST

参数名称必填类型默认值取值范围【正则表达式】描述
returnStringjson,【.+】返回类型

请求示例:https://api.xiwangly.top/yiyan.php

返回格式:TEXT/JSON

输出随机一言

Ping

请求地址:https://api.xiwangly.top/ping.php

请求方式:GET/POST

参数名称必填类型默认值取值范围【正则表达式】描述
ipString【[^\s]*】IP或域名

请求示例:https://api.xiwangly.top/ping.php?ip=127.0.0.1

返回格式:TEXT

网络诊断工具,测试网络连通性

开源地址:xiwangly_ping

Dic

请求地址:

请求方式:GET

参数名称必填类型默认值取值范围【正则表达式】描述
qString第一个空格前(不包括第一个空格)问题
aString第一个空格到第二个空格之间(不包括空格)回答

请求示例:

返回格式:TEXT

开源地址:sqldic.php

随机图片(试运行)

请求地址:https://e52.top/image-cs.php

https://api.xiwangly.top/image-cs.php

请求方式:GET/POST

参数名称必填类型默认值取值范围【正则表达式】描述
keyString123456【.+】密钥
typeStringbz,【.+】图片类型
returnStringprint,json,【.+】返回类型

请求示例: https://e52.top/image-cs.php?key=123456&return=json

返回格式:Images/JSON

输出一张随机二次元图片,type填bz输出壁纸,不填或填其他默认方法输出,return填print直接通过脚本输出(URL固定),填json输出JSON,不填或填其他默认从源URL输出,图片保存在本地

随机图片-数据库版本(试运行)

请求地址:https://e52.top/images-cs.php

https://api.xiwangly.top/images-cs.php

请求方式:GET/POST

参数名称必填类型默认值取值范围【正则表达式】描述
keyString123456【.+】密钥类型
typeStringbz,【.+】返回类型

请求示例: https://e52.top/images-cs.php?key=123456

返回格式:Images

输出一张随机二次元图片,type填bz输出壁纸, 不填或填其他默认方法输出,图片保存在数据库

ACG随机图片

请求地址:https://api.xiwangly.top/random.php

请求方式:GET/POST

参数名称必填类型默认值取值范围【正则表达式】描述
returnStringimg,json,jsonpro,【.+】返回类型

请求示例: https://api.xiwangly.top/random.php?return=json

返回格式:Images/JSON

输出一张随机二次元图片,return填img浏览器直接输出图片,填json按JSON格式输出,填jsonpro则随机JSON输出10张图片,不填或填其他直接跳转到源图片URL,图片保存在新浪(sinaimg.cn)。

处理过程:

返回示例:

{
    "code":"200",
    "imgurl":"https://tva1.sinaimg.cn/large/006ZFECEgy1fr1x6emudfj31hc0u0nkd.jpg",
    "width":"1920",
    "height":"1080",
    "mime":"image/jpeg"
}

开源地址:acg-img-url-radom-api

Live2D看板娘

请求地址:https://api.xiwangly.top/live2d/autoload.js

https://xiwangly.top/live2d_load/autoload.js

请求示例及开源地址见live2d-widgetlive2d

Pinyin

请求地址:https://api.xiwangly.top/pinyin.php

请求方式:GET/POST

参数名称必填类型默认值取值范围【正则表达式】描述
textString【.*】文本
returnStringconvert_pinyinconvert_pinyin,convert_pinyin_tone,convert_pinyin_ascii_tone,permalink,permalink_.,link,link.,abbr,abbr_-,abbr_pinyin_keep_number,abbr_pinyin_keep_english,sentence,sentence_pinyin_tone,name,name_tone返回类型

请求示例:https://api.xiwangly.top/pinyin.php?text=带着希望去旅行&return=permalink

返回格式:TEXT/JSON

开源地址:引用自overtrue/pinyin,感谢这些大佬们的开源项目

用于将汉字转换成拼音,permalink等同linkpermalink_.等同link.,注意下划线和英文句号(仅仅是为了简化表示)

User-Agent

请求地址:https://api.xiwangly.top/ua.php

https://api.xiwangly.top/ua-lookup.php

前者是我自己修改的一个简单的ua获取脚本,不需要提供任何参数;后者采用php的get_browser()函数实现,更全面响应也更慢,我采用了full_php_browscap.ini文件,支持指定ua查询

请求方式:GET/POST

参数名称必填类型默认值取值范围【正则表达式】描述
uaString【.*】User-Agent

请求示例:https://api.xiwangly.top/ua-lookup.php?ua=Mozilla/5.0%20(Windows%20NT%2010.0;%20Win64;%20x64)%20AppleWebKit/537.36%20(KHTML,%20like%20Gecko)%20Chrome/103.0.0.0%20Safari/537.36

返回格式:TEXT/Images/JSON/XML

开源地址:

返回示例:

前者:

{
    "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36",
    "os": "Windows 10 x64",
    "method": "GET",
    "language": "zh-CN,zh;q=0.9,en;q=0.8",
    "ip": "2409:8a38:5614:f440:adf9:e142:c144:2624",
    "uri": "/ua.php",
    "browser": "Chrome",
    "referer": null,
    "time": 1659147283
}

后者:

{
    "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36",
    "method": "GET",
    "language": "zh-CN,zh;q=0.9,en;q=0.8",
    "ip": "116.80.41.20",
    "uri": "/ua-lookup.php?ua=Mozilla/5.0%20(Windows%20NT%2010.0;%20Win64;%20x64)%20AppleWebKit/537.36%20(KHTML,%20like%20Gecko)%20Chrome/103.0.0.0%20Safari/537.36",
    "referer": null,
    "time": 1659160602,
    "browser_name_regex": "~^mozilla/5\\.0 \\(.*windows nt 10\\.0.*win64. x64.*\\) applewebkit.* \\(.*khtml.*like.*gecko.*\\) chrome/103\\.0.*safari/.*$~",
    "browser_name_pattern": "Mozilla/5.0 (*Windows NT 10.0*Win64? x64*) applewebkit* (*khtml*like*gecko*) Chrome/103.0*Safari/*",
    "parent": "Chrome 103.0",
    "browser_bits": "64",
    "platform": "Win10",
    "platform_version": "10.0",
    "platform_description": "Windows 10",
    "platform_bits": "64",
    "platform_maker": "Microsoft Corporation",
    "win64": "1",
    "comment": "Chrome 103.0",
    "browser": "Chrome",
    "browser_type": "Browser",
    "browser_maker": "Google Inc",
    "version": "103.0",
    "majorver": "103",
    "frames": "1",
    "iframes": "1",
    "tables": "1",
    "cookies": "1",
    "javascript": "1",
    "cssversion": "3",
    "aolversion": "0",
    "device_name": "Windows Desktop",
    "device_type": "Desktop",
    "device_pointing_method": "mouse",
    "device_code_name": "Windows Desktop",
    "renderingengine_name": "Blink",
    "renderingengine_description": "a WebKit Fork by Google",
    "renderingengine_maker": "Google Inc",
    "browser_modus": "unknown",
    "minorver": "0",
    "alpha": "",
    "beta": "",
    "win16": "",
    "win32": "",
    "backgroundsounds": "",
    "vbscript": "",
    "javaapplets": "",
    "activexcontrols": "",
    "ismobiledevice": "",
    "istablet": "",
    "issyndicationreader": "",
    "crawler": "",
    "isfake": "",
    "isanonymized": "",
    "ismodified": "",
    "device_maker": "unknown",
    "device_brand_name": "unknown",
    "renderingengine_version": "unknown"
}

名称(模板)

请求地址:

请求方式:GET/POST

(请求表单)

请求示例:

返回格式:TEXT/Images/JSON/XML

开源地址:

(其他)

JSON公共返回值

键名可能的值描述
code(请通过互联网自行查找)HTTP状态码
text文本
msg消息
messagemsg的别名
idID
name名称
data数据
bin二进制数据

本站不是所有的json输出都遵循此设定

其他

旧的API文档:https://www.lolichan.vip/threads/api-xiwangly-api.205/