suo.run | 快缩短网址
—— 让每一次分享都轻盈如诗
一、缘起
长链冗长,字符如藤蔓;短链精炼,一瞬即达。快缩短网址(suo.run)以极简之道,将庞杂的 URL 化作四字符短码,既省字符,又藏锋芒,助你在短信、邮件、微信、QQ、自媒体乃至暗色渠道中,优雅地抵达用户指尖。
二、四种短链格式
1. https://suo.run/xxxx
2. https://suo.run/xx/xxxx
3. https://suo.run/qr/xxxx (带二维码)
4. https://suo.run/api/xxxx (纯 API 返回)
三、接口文档

1. 请求方式
GET
2. 返回格式
JSON:{"code":200,"short":"https://suo.run/AbCd"}
3. 在线即用
浏览器地址栏输入:
https://suo.run/create?url=YOUR_LONG_URL
(YOUR_LONG_URL 须以 http/https 开头,必要时先做 urlencode)
4. 服务器调用示例
PHP
$long = 'https://www.example.com/page?utm=hello';
$api = 'https://suo.run/create?url=' . urlencode($long);
$json = file_get_contents($api);
$short = json_decode($json, true)['short'];
echo $short; // https://suo.run/AbCd
Java
String longUrl = "https://www.example.com/page?utm=hello";
String api = "https://suo.run/create?url=" + URLEncoder.encode(longUrl, "UTF-8");
try (InputStream in = new URL(api).openStream()) {
String json = new String(in.readAllBytes(), StandardCharsets.UTF_8);
System.out.println(new JSONObject(json).getString("short"));
}
Python
import urllib.parse, urllib.request, json
long = 'https://www.example.com/page?utm=hello'
api = 'https://suo.run/create?url=' + urllib.parse.quote(long)
short = json.loads(urllib.request.urlopen(api).read())['short']
print(short) # https://suo.run/AbCd

四、优雅须知
• 长链含特殊字符时,务必 urlencode。
• 建议调用频率 ≤ 1 次/秒,云端将自动缓存。
• 共享接口生成的短链默认有效期 180 天;企业版永久有效,不限访问次数。
• 若原链被屏蔽,接口返回 code=403,可联系客服申诉。
五、常见问答
Q:参数丢失了?
A:未 urlencode 所致,请先编码再请求。
Q:接口无响应?
A:可能触发风控或网络超时,重试或更换出口 IP。
Q:能否自定义短码?
A:企业版支持自定义 4–6 位字母数字组合,先到先得。
Q:支持批量生成吗?
A:企业版开放 /batch 接口,一次最多 1000 条,返回 CSV 或 JSON。
六、即刻体验
浏览器输入 suo.run,或把 suo.run/create?url= 加在你的长链之后,轻轻一按,冗长即化为指尖的清风。