「快缩短网址」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

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);

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