短链接 API 接入指南：开发者的集成方案

为什么需要 API 集成

手动生成短链接够用了，但需要在应用、小程序、CMS 中自动生成时，API 可以让程序自动调用，批量生成短码。

API 基本原理

短链接 API 通常遵循 RESTful 设计：生成短链接（POST 提交目标网址，返回短码），访问短链接（GET 短码，301 跳转到目标网址）。

集成注意事项

短码唯一性：每个短码在系统中唯一，建议先检查短码是否可用。

请求频率限制：API 通常有频率限制，批量生成请控制频率或申请更高配额。

错误处理：做好网络超时重试、错误码日志记录、降级方案（API 不可用时生成随机短码）。

HTTPS：所有 API 请求使用 HTTPS，确保传输安全。

应用场景

电商商品链接自动生成短链接方便分享、CMS 发布文章时自动生成短链接、营销自动化工具在发送邮件时替换链接为短链接、小程序分享功能使用短链接减少长度。

附近：一个完整的最小接入示例

以 PHP 为例，展示调用短链接 API 的核心逻辑（仅示意，9H 的开放 API 以正式文档为准）：

// 生成短链接
$ch = curl_init('https://api.9h.hk/shorten');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'url' => 'https://example.com/long/path',
    'code' => 'mycode'   // 可选
]));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$resp = curl_exec($ch);
$data = json_decode($resp, true);
echo $data['short_url'];  // https://9h.hk/mycode

接入后的监控与告警

API 接入只是第一步，上线后还要持续监控：

• 短码冲突告警：批量生成时注意收集失败响应，短码占用是常见错误
• 请求成功率：建议记录每天的成功/失败比例，如果异常下降，及时排查是网络问题还是服务问题
• 配额预警：在接近频率上限前设置提醒，避免高峰期被限流
• 备用链路：关键业务建议做双保险——API 故障时降级为直接使用长链接，保证业务不中断