接入指南

三步完成对接：注册拿密钥 → 拼调用链接 → 读取 JSON 结果。稳定 · 极速 · 安全的 API 接口管理平台

快速开始接口一览天气二维码短链接 IP 查询代码示例响应格式错误码配额注意事项

快速开始（3 步）

注册并创建密钥

打开 register.php 注册账号 → 登录后进入「密钥管理」创建密钥，复制形如 ak-xxxx 的密钥。

拼调用地址

所有接口共用入口：https://api.isqq.cc/api.php?path=接口标识

带上密钥

推荐请求头 X-API-Key: ak-xxxx；只能用链接对接时，在 URL 末尾加 &apikey=ak-xxxx。

没有密钥时，所有接口均返回 401。全部接口都必须携带有效密钥，防止匿名滥用。

接口一览

接口	标识 path=	方法	需密钥	计费
天气查询	weather	GET	是	免费
二维码生成	qrcode	GET / POST	是	免费
短链接生成	short-url	GET / POST	是	免费
IP 归属地查询	ip-lookup	GET	是	免费

短链接生成需要密钥；但生成后的短链任何人打开都无需密钥（跳转本身是公开的），可放心对外传播。

天气查询免费

参数	必填	说明
city	是	城市名，支持中文；也接受 location / q

链接示例（中文需 URL 编码，广州 → %E5%B9%BF%E5%B7%9E）：

https://api.isqq.cc/api.php?path=weather&city=%E5%B9%BF%E5%B7%9E&apikey=你的密钥

{
  "code": 0,
  "message": "请求成功",
  "data": {
    "city": "广州",
    "current": { "temperature": 26.4, "weather": "多云", "humidity": 78 },
    "daily": [ { "date": "2026-10-18", "temp_max": 30, "temp_min": 22 } ]
  },
  "timestamp": 1792330000
}

二维码生成免费

参数	必填	说明
data	是	要生成二维码的文本或链接，支持中文
size	否	尺寸，300 或 300x300，范围 50~1000，默认 300
format	否	json（默认）或 image（直接输出 PNG）

① 拿 JSON（含图片地址与 base64）：

https://api.isqq.cc/api.php?path=qrcode&data=http%3A%2F%2Fapi.isqq.cc&size=300&apikey=你的密钥

② 直接输出图片（可放进 <img src>）：

https://api.isqq.cc/api.php?path=qrcode&data=http%3A%2F%2Fapi.isqq.cc&format=image&apikey=你的密钥

<img src="https://api.isqq.cc/api.php?path=qrcode&data=http%3A%2F%2Fapi.isqq.cc&format=image&apikey=你的密钥">

响应里的 image_url 已自动附带你的密钥，浏览器或 <img> 直接打开即可显示，不会再提示缺少密钥。

短链接生成免费

参数	必填	说明
url	是	原始长链接，需以 http:// 或 https:// 开头

链接示例（GET 即可，无需 POST）：

https://api.isqq.cc/api.php?path=short-url&url=https%3A%2F%2Fwww.qq.com&apikey=你的密钥

{
  "code": 0,
  "message": "请求成功",
  "data": {
    "original_url": "https://www.qq.com",
    "short_url": "https://api.isqq.cc/s/TVIcPm",
    "code": "TVIcPm",
    "provider": "local"
  },
  "timestamp": 1792335231
}

生成的是伪静态短链：https://api.isqq.cc/s/短码。任何人点击都会 302 跳转到原始地址，访问无需密钥。

IP 归属地查询免费

参数	必填	说明
ip	否	要查询的 IP；留空则查调用者自己的公网 IP

链接示例：

https://api.isqq.cc/api.php?path=ip-lookup&ip=223.5.5.5&apikey=你的密钥

代码示例

cURL（请求头方式，推荐）

curl "https://api.isqq.cc/api.php?path=weather&city=%E5%B9%BF%E5%B7%9E" \
  -H "X-API-Key: ak-你的密钥"

JavaScript

const KEY = 'ak-你的密钥';
const res = await fetch('https://api.isqq.cc/api.php?path=weather&city=' + encodeURIComponent('广州'), {
  headers: { 'X-API-Key': KEY }
});
const json = await res.json();
if (json.code === 0) {
  console.log(json.data.current.temperature);
} else {
  console.error(json.code, json.message);
}

PHP

$url  = 'https://api.isqq.cc/api.php?path=weather&city=' . urlencode('广州');
$ch   = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['X-API-Key: ak-你的密钥'],
]);
$json = json_decode(curl_exec($ch), true);

Python

import requests
r = requests.get(
    'https://api.isqq.cc/api.php',
    params={'path': 'weather', 'city': '广州'},
    headers={'X-API-Key': 'ak-你的密钥'},
    timeout=15,
)
print(r.json())

统一响应格式

{
  "code": 0,               // 0 表示成功
  "message": "请求成功",
  "data": { },             // 业务数据，内容取决于接口
  "timestamp": 1792330000
}

code = 0 即调用成功，业务数据都在 data 里。

错误码对照

HTTP	code	含义	处理建议
200	0	成功	读取 data
401	401	缺少密钥 / 密钥无效或已过期	检查密钥是否填写、是否被停用
403	403	接口已停用	联系平台方
404	404	接口不存在	检查 path= 是否正确
405	405	请求方法不被允许	对照接口要求的 GET / POST
429	429	配额不足（仅付费接口）	用卡密充值或联系管理员
502	502	上游服务暂时不可用	稍后重试

配额说明

免费接口（当前 4 个接口均为免费）：不消耗配额，配额不足也能正常调用。

付费接口：每次成功调用消耗平台设定的配额数（可由平台自定义 N 次/次）。

配额不足时，在 /user/redeem.php 用卡密充值，或联系管理员添加配额。

对接注意事项

中文参数必须 URL 编码，否则会乱码或参数丢失。

密钥不要写在前端页面里（会被看到）。服务端对接务必用请求头方式。

密钥会过期，过期后返回 401，联系平台方续期。

短链接：生成需密钥，访问不需密钥，可放心对外传播。

遇到问题时，提供 timestamp 与调用时的完整 URL，便于平台方在日志中定位。

需要更多接口或更高配额，请联系平台管理员 · 查看接口文档与在线测试