API接入文档 – 雪舞api

🚀 快速开始

所有 API 通过 HTTP 协议调用，仅需在请求中传入 apikey 参数即可完成鉴权。注册后自动获得专属 apikey，登录后可在个人中心查看。

🔑 鉴权方式

请求格式

GET/POST /api/{接口名称}?apikey={你的apikey}&{参数1}={值1}&{参数2}={值2}

接口名称作为 URL 路径，apikey 和业务参数作为 QueryString，就是这么简单。

💻 代码示例

cURL

curl "https://你的域名/api/phone_info?phone=13800138000&apikey=你的apikey"

Python

import requests

params = {
    "phone": "13800138000",
    "apikey": "你的apikey"
}

resp = requests.get("https://你的域名/api/phone_info", params=params)
print(resp.json())

JavaScript (fetch)

const params = new URLSearchParams({
    phone: "13800138000",
    apikey: "你的apikey"
});

fetch("https://你的域名/api/phone_info?" + params.toString())
    .then(r => r.json())
    .then(data => console.log(data));

PHP

$url = "https://你的域名/api/phone_info?" . http_build_query([
    "phone" => "13800138000",
    "apikey" => "你的apikey",
]);

$result = file_get_contents($url);
print_r(json_decode($result, true));

⚠ 错误码说明

HTTP状态码	说明
200	请求成功
400	缺少必要参数 (path / apikey)
401	apikey 无效
402	余额不足
403	无权限 / VIP等级不够 / 接口不可用
404	接口不存在
429	调用次数超限

📚 接口列表

工具类

接口名称	路径	方式	定价	详情
二维码生成	qrcode	GET	免费	查看
IP归属地查询	ipinfo	GET	免费	查看
短网址生成	shorturl	GET	免费	查看
网站Favicon图标	favicon	GET	免费	查看
Base64编解码	base64	GET	免费	查看
URL编解码	urlencode	GET	免费	查看
Bing收录查询	bingindex	GET	免费	查看
获取网页TDK	gettdk	GET	免费	查看
网站快照截图	sitesnapshot	GET	免费	查看
ICP备案查询	icpcheck	GET	免费	查看

图片类

接口名称	路径	方式	定价	详情
手机归属地查询	phoneinfo	GET	免费	查看
天气查询	weather	GET	免费	查看
历史上的今天	historytoday	GET	免费	查看

文字类

接口名称	路径	方式	定价	详情
随机一言	hitokoto	GET	免费	查看
随机古诗词	poetry	GET	免费	查看
随机二次元图片	pixiv	GET	免费	查看
汉字转拼音	pinyin	GET	免费	查看

📤 返回格式

所有接口统一返回 JSON 格式：

{
  "code": 1,
  "msg": "请求成功",
  "time": 1700000000,
  "data": {
    "phone": "13800138000",
    "province": "北京",
    "city": "北京",
    "isp": "移动"
  }
}

字段	类型	说明
code	int	1=成功，0=失败
msg	string	提示信息
time	int	服务器时间戳
data	object/null	返回数据

API 接入文档

🚀 快速开始

🔑 鉴权方式

请求格式

💻 代码示例

cURL

Python

JavaScript (fetch)

PHP

⚠ 错误码说明

📚 接口列表

工具类

图片类

文字类

📤 返回格式