长链秒变短链的API实战

「快缩短网址」API 使用手册
优雅地把冗长变成轻盈，从 suo.run 开始。

一、API 概览
suo.run 提供极简 REST 接口，将任何长链压缩为形如 suo.run/xxx 的短链。
支持两种调用风格：
• GET https://suo.run/short?url=长链
• GET https://suo.run/api?key=密钥&url=长链

二、鉴权（可选）
公共接口无需密钥，若需更高配额或统计，请：
1. 访问 suo.run →「API 控制台」
2. 注册并生成专属 Access-Key
3. 在请求中追加 key=Access-Key

三、调用细节
1. 在线即用
直接在浏览器地址栏输入：
https://suo.run/short?url=https://example.com/very/long/path?utm=123
回车即可得到短链。

2. 程序集成
长链务必 URL-Encode，尤其含 &、=、空格等特殊字符时。

四、代码片段
PHP

$long  = 'https://example.com/very/long/path?utm=123';

$short = file_get_contents('https://suo.run/short?url=' . urlencode($long));

echo $short; // suo.run/AbCdE

Java

URI uri = new URI("https", "suo.run", "/short",

        "url=" + URLEncoder.encode(longUrl, StandardCharsets.UTF_8), null);

HttpRequest req = HttpRequest.newBuilder(uri).GET().build();

String shortUrl = HttpClient.newHttpClient()

                            .send(req, BodyHandlers.ofString())

                            .body();

System.out.println(shortUrl);

Python

import requests, urllib.parse

long_url = 'https://example.com/very/long/path?utm=123'

short = requests.get('https://suo.run/short',

                     params={'url': long_url}).text

print(short)  # suo.run/AbCdE

五、优雅实践
• 始终使用 https:// 或 http:// 开头
• & 字符请替换为 %26 或整体 URL-Encode
• 建议缓存结果，减少重复调用

六、常见疑问
Q1：参数丢失？
A：未正确编码导致。请整体 URL-Encode 后再提交。

Q2：接口无返回？
A：可能原链被屏蔽、网络超时或触发风控。重试或更换域名即可。

Q3：短链有效期？
A：永久有效，访问次数无上限。



把世界的冗长，交给 suo.run 轻轻折叠。