简单、自主的 API 服务

12 个接口统一入口:二维码、占位图、一言、随机头像、文本工具……自主 API 纯本地生成,不依赖任何第三方。

// 试试看,无需密钥
GET https://api.ikunwl.com/api.php?type=qrcode&text=https://ikunwl.com
12
API 接口
4
今日调用
665
总调用次数
8
自主 API

QQ头像

代理
qq_avatar

通过QQ号码获取对应的头像图片,支持多种尺寸选择(代理第三方,带24小时本地缓存)

今日 0 总调用 247

接口描述

通过QQ号码获取对应的头像图片,支持多种尺寸选择(代理第三方,带24小时本地缓存)

请求端点

GET api.php?type=qq_avatar

参数说明

参数名必须说明
qq 是 QQ号码(必须为5-13位数字)
size 否 头像尺寸,可选值:40, 64, 100, 140, 640(默认640)
qq 必须
QQ号码(必须为5-13位数字)
size 可选
头像尺寸,可选值:40, 64, 100, 140, 640(默认640)

调用示例

基础调用: https://api.ikunwl.com/api.php?type=qq_avatar&qq=123456
指定尺寸: https://api.ikunwl.com/api.php?type=qq_avatar&qq=123456&size=100

返回数据

直接返回JPEG格式的头像图片,可直接用于img标签

注意事项

  • 获取的头像链接具有24小时缓存,频繁请求相同QQ号码会返回缓存结果
  • 限流策略:每个IP每分钟60次

网站TDK+权重

代理
meta_api

提取指定URL的标题、关键词、描述、网站图标及搜索引擎权重信息

今日 0 总调用 203

接口描述

提取指定URL的标题、关键词、描述、网站图标及搜索引擎权重信息

请求端点

GET api.php?type=meta_api

参数说明

参数名必须说明
url 是 目标网址(需包含http://或https://协议)
api_key 否 5118 API密钥(可选,用户可以传递自己的API密钥,提高查询限额)
url 必须
目标网址(需包含http://或https://协议)
api_key 可选
5118 API密钥(可选,用户可以传递自己的API密钥,提高查询限额)

调用示例

基础调用: https://api.ikunwl.com/api.php?type=meta_api&url=https://ikunwl.com
使用自己的API密钥: https://api.ikunwl.com/api.php?type=meta_api&url=https://ikunwl.com&api_key=YOUR_5118_API_KEY

返回数据

返回JSON格式数据,包含title(标题)、key(关键词)、desc(描述)、icon(图标)及各搜索引擎权重

注意事项

  • 结果缓存7天,相同URL的重复请求会返回缓存数据以提高性能
  • 默认使用系统API密钥,可能存在查询限额限制
  • 建议用户使用自己的5118 API密钥,以获得更高的查询限额和更稳定的服务

友链检测

代理
link_check

检测指定网页中是否包含目标域名的友情链接,支持多种链接格式识别与验证

今日 1 总调用 117

接口描述

检测指定网页中是否包含目标域名的友情链接,支持多种链接格式识别与验证

请求端点

GET api.php?type=link_check

参数说明

参数名必须说明
url 是 要检测的目标域名(例如:ikunwl.com)
links 是 需要检查的网页地址(例如:https://example.com)
url 必须
要检测的目标域名(例如:ikunwl.com)
links 必须
需要检查的网页地址(例如:https://example.com)

调用示例

基础调用: https://api.ikunwl.com/api.php?type=link_check&url=ikunwl.com&links=example.com

返回数据

返回JSON格式数据,包含:status(检测状态)、target_domain(目标域名)、checked_url(被检查网页)、matched_link(匹配到的友链地址)

注意事项

  • 结果缓存1小时,避免频繁请求同一网址
  • 自动忽略javascript:、mailto:等非网页链接
  • 支持带端口号、路径参数的复杂URL检测

权重获取

代理
rank

获取指定网站的搜索引擎权重信息,包括百度PC、百度移动、好搜、神马和头条权重

今日 1 总调用 11

接口描述

获取指定网站的搜索引擎权重信息,包括百度PC、百度移动、好搜、神马和头条权重

请求端点

GET api.php?type=rank

参数说明

参数名必须说明
url 是 目标网址(需包含http://或https://协议)
api_key 否 5118 API密钥(可选,用户可以传递自己的API密钥,提高查询限额)
url 必须
目标网址(需包含http://或https://协议)
api_key 可选
5118 API密钥(可选,用户可以传递自己的API密钥,提高查询限额)

调用示例

基础调用: https://api.ikunwl.com/api.php?type=rank&url=https://ikunwl.com
使用自己的API密钥: https://api.ikunwl.com/api.php?type=rank&url=https://ikunwl.com&api_key=YOUR_5118_API_KEY

返回数据

返回JSON格式数据,包含网站在百度PC、百度移动、好搜、神马和头条的权重信息

注意事项

  • 结果缓存7天,相同URL的重复请求会返回缓存数据以提高性能
  • 默认使用系统API密钥,可能存在查询限额限制
  • 建议用户使用自己的5118 API密钥,以获得更高的查询限额和更稳定的服务

二维码生成

自主
qrcode

纯本地生成SVG二维码,不依赖任何第三方服务,内容编码后直接输出图片

今日 0 总调用 19

接口描述

纯本地生成SVG二维码,不依赖任何第三方服务,内容编码后直接输出图片

请求端点

GET api.php?type=qrcode

参数说明

参数名必须说明
text 是 要编码的内容(最大213字节,约70个汉字)
size 否 输出尺寸,64-2048像素(默认300)
fg 否 前景色,格式#RRGGBB(默认#000000)
bg 否 背景色,格式#RRGGBB(默认#ffffff)
margin 否 静区大小,0-16模块(默认4)
text 必须
要编码的内容(最大213字节,约70个汉字)
size 可选
输出尺寸,64-2048像素(默认300)
fg 可选
前景色,格式#RRGGBB(默认#000000)
bg 可选
背景色,格式#RRGGBB(默认#ffffff)
margin 可选
静区大小,0-16模块(默认4)

调用示例

生成网址二维码: https://api.ikunwl.com/api.php?type=qrcode&text=https://ikunwl.com
自定义尺寸与颜色: https://api.ikunwl.com/api.php?type=qrcode&text=hello&size=400&fg=3b82f6
高容错内容: https://api.ikunwl.com/api.php?type=qrcode&text=你好世界&margin=8

返回数据

直接返回SVG格式的二维码图片,可直接用于img标签

注意事项

  • 采用纠错级别M(约15%容错)
  • 内容过长时返回400错误,请缩短内容
  • 建议上线后用手机扫码验证一次可扫性

占位图

自主
placeholder

纯本地生成占位图(类似 via.placeholder.com),支持SVG和PNG两种格式

今日 1 总调用 28

接口描述

纯本地生成占位图(类似 via.placeholder.com),支持SVG和PNG两种格式

请求端点

GET api.php?type=placeholder

参数说明

参数名必须说明
w 否 宽度,10-2000像素(默认400)
h 否 高度,10-2000像素(默认300)
text 否 显示文字(默认 "宽 x 高")
bg 否 背景色,3或6位十六进制(默认cccccc)
fg 否 前景色(文字颜色),3或6位十六进制(默认333333)
format 否 输出格式:svg(默认)或 png(需GD扩展)
w 可选
宽度,10-2000像素(默认400)
h 可选
高度,10-2000像素(默认300)
text 可选
显示文字(默认 "宽 x 高")
bg 可选
背景色,3或6位十六进制(默认cccccc)
fg 可选
前景色(文字颜色),3或6位十六进制(默认333333)
format 可选
输出格式:svg(默认)或 png(需GD扩展)

调用示例

基础占位图: https://api.ikunwl.com/api.php?type=placeholder&w=600&h=400
带文字和颜色: https://api.ikunwl.com/api.php?type=placeholder&w=600&h=400&text=iKun&bg=3b82f6&fg=ffffff
PNG格式: https://api.ikunwl.com/api.php?type=placeholder&w=400&h=300&format=png

返回数据

直接返回SVG或PNG格式的占位图图片

注意事项

  • SVG格式无需GD扩展,默认输出SVG
  • PNG格式需要服务器启用GD扩展,未启用时返回500错误
  • 文字过长时自动缩小字号适应画布

一言

自主
hitokoto

从内置词库中随机返回一句话(纯本地生成,不依赖第三方)

今日 0 总调用 5

接口描述

从内置词库中随机返回一句话(纯本地生成,不依赖第三方)

请求端点

GET api.php?type=hitokoto

参数说明

参数名必须说明
type 否 分类:all(默认)、inspire(励志)、poem(诗词)、tech(科技)、life(生活)、friendship(友情)
type 可选
分类:all(默认)、inspire(励志)、poem(诗词)、tech(科技)、life(生活)、friendship(友情)

调用示例

随机一言: https://api.ikunwl.com/api.php?type=hitokoto
励志分类: https://api.ikunwl.com/api.php?type=hitokoto&type=inspire
诗词分类: https://api.ikunwl.com/api.php?type=hitokoto&type=poem

返回数据

返回JSON格式数据,包含id、text(一句话)、from(来源)、type(分类)

注意事项

  • 词库内置60条原创语句,无需网络请求
  • 不认识的type会自动回退到all

随机头像

自主
avatar

按种子(seed)生成确定性几何风格SVG头像,同一种子永远生成同一头像(纯本地)

今日 1 总调用 18

接口描述

按种子(seed)生成确定性几何风格SVG头像,同一种子永远生成同一头像(纯本地)

请求端点

GET api.php?type=avatar

参数说明

参数名必须说明
seed 否 头像种子(用户名/昵称等),同一种子头像固定(默认随机生成)
size 否 输出尺寸,32-1024像素(默认200)
bg 否 背景色,3或6位十六进制(默认按种子自动配色)
seed 可选
头像种子(用户名/昵称等),同一种子头像固定(默认随机生成)
size 可选
输出尺寸,32-1024像素(默认200)
bg 可选
背景色,3或6位十六进制(默认按种子自动配色)

调用示例

随机头像: https://api.ikunwl.com/api.php?type=avatar
固定种子头像: https://api.ikunwl.com/api.php?type=avatar&seed=ikun
自定义尺寸: https://api.ikunwl.com/api.php?type=avatar&seed=ikun&size=400

返回数据

直接返回SVG格式的几何风格头像图片

注意事项

  • 同一seed永远生成同一头像,适合做用户默认头像
  • 颜色由种子哈希派生,配色稳定且各不相同
  • 纯本地生成,无需任何第三方服务

时间

自主
time

纯本地返回服务器时间信息,支持时间戳与日期互转

今日 0 总调用 5

接口描述

纯本地返回服务器时间信息,支持时间戳与日期互转

请求端点

GET api.php?type=time

参数说明

参数名必须说明
type 否 类型:now(默认,当前时间)、convert(时间戳/日期互转)
from 否 type=convert时:timestamp(默认)或 date
value 否 type=convert时:待转换的时间戳或日期(如 2026-09-14 或 1726294400)
type 可选
类型:now(默认,当前时间)、convert(时间戳/日期互转)
from 可选
type=convert时:timestamp(默认)或 date
value 可选
type=convert时:待转换的时间戳或日期(如 2026-09-14 或 1726294400)

调用示例

当前时间: https://api.ikunwl.com/api.php?type=time
日期转时间戳: https://api.ikunwl.com/api.php?type=time&type=convert&from=date&value=2026-09-14
时间戳转日期: https://api.ikunwl.com/api.php?type=time&type=convert&from=timestamp&value=1726294400

返回数据

返回JSON格式数据,包含timestamp、iso8601、date、time、datetime、weekday、timezone、utc_offset

注意事项

  • 毫秒级时间戳(13位)会自动转换为秒
  • 纯本地生成,无第三方依赖

IP信息

自主
ip

返回请求者的IP、User-Agent、请求方法等请求信息(纯本地)

今日 0 总调用 6

接口描述

返回请求者的IP、User-Agent、请求方法等请求信息(纯本地)

请求端点

GET api.php?type=ip

调用示例

查看我的IP: https://api.ikunwl.com/api.php?type=ip

返回数据

返回JSON格式数据,包含ip、user_agent、method、protocol、host、path、language、is_local、server_time

注意事项

  • IP取自客户端地址(CDN/反代场景取X-Forwarded-For,可在config中关闭)
  • 纯本地生成,无第三方依赖

文本工具

自主
tool

纯本地文本处理工具:哈希、编码解码、大小写转换、反转、随机串、UUID等

今日 0 总调用 0

接口描述

纯本地文本处理工具:哈希、编码解码、大小写转换、反转、随机串、UUID等

请求端点

GET api.php?type=tool

参数说明

参数名必须说明
type 是 工具类型:md5、sha1、sha256、base64_encode、base64_decode、url_encode、url_decode、upper、lower、reverse、strlen、random、uuid
text 否 待处理文本(random/uuid类型不需要,其他类型必填,最大10000字符)
length 否 type=random时随机串长度,1-1024,默认16
charset 否 type=random时字符集:alnum(默认)、alpha、num、hex、symbol
type 必须
工具类型:md5、sha1、sha256、base64_encode、base64_decode、url_encode、url_decode、upper、lower、reverse、strlen、random、uuid
text 可选
待处理文本(random/uuid类型不需要,其他类型必填,最大10000字符)
length 可选
type=random时随机串长度,1-1024,默认16
charset 可选
type=random时字符集:alnum(默认)、alpha、num、hex、symbol

调用示例

MD5加密: https://api.ikunwl.com/api.php?type=tool&type=md5&text=hello
Base64编码: https://api.ikunwl.com/api.php?type=tool&type=base64_encode&text=hello
随机字符串: https://api.ikunwl.com/api.php?type=tool&type=random&length=32
生成UUID: https://api.ikunwl.com/api.php?type=tool&type=uuid

返回数据

返回JSON格式数据,包含type、input(原始输入)、output(处理结果)

注意事项

  • 完全自主实现,无需第三方服务
  • 非UTF-8的Base64解码结果会以HEX形式返回,保证JSON兼容
  • text参数最大支持10000字符,防止滥用

随机数据

自主
random

纯本地随机数据生成:随机整数、随机字符串、随机颜色、UUID、随机布尔值

今日 0 总调用 5

接口描述

纯本地随机数据生成:随机整数、随机字符串、随机颜色、UUID、随机布尔值

请求端点

GET api.php?type=random

参数说明

参数名必须说明
type 否 类型:number(默认)、string、color、uuid、bool
min 否 type=number时最小值,默认0
max 否 type=number时最大值,默认100
length 否 type=string时长度,1-1024,默认16
format 否 type=color时格式:hex(默认)或 rgb
type 可选
类型:number(默认)、string、color、uuid、bool
min 可选
type=number时最小值,默认0
max 可选
type=number时最大值,默认100
length 可选
type=string时长度,1-1024,默认16
format 可选
type=color时格式:hex(默认)或 rgb

调用示例

随机整数: https://api.ikunwl.com/api.php?type=random&type=number&min=1&max=100
随机颜色: https://api.ikunwl.com/api.php?type=random&type=color
随机字符串: https://api.ikunwl.com/api.php?type=random&type=string&length=32
生成UUID: https://api.ikunwl.com/api.php?type=random&type=uuid

返回数据

返回JSON格式数据,包含type和value(随机结果)

注意事项

  • 使用PHP的random_int/random_bytes,密码学安全随机源
  • 适合抽奖、占位数据、测试数据生成等场景