🔌
API 服务付费授权
把 9H 短链接生成能力，接进你的网站与系统
🚀服务说明
9H API 开放自助开通：登录后在个人中心即可领取专属 API Key，把短链接生成部署到任意网站、App 或后台系统里直接调用，无需跳转到 9H 网页。所有经 API 生成的链接与站内生成完全一致，经过同一套五层安全校验与 Google Safe Browsing 检查，支持自定义短码，并可随时查询点击统计与剩余配额。
适合：自有网站的内容系统、营销落地页批量生成、企业内部工具、电商与社群运营等场景。网页端的免费生成保持不变，API 面向需要程序化、批量与白标整合的用户，免费档可直接自助开通，批量需求可升级付费套餐。
🧩接口一览
基础地址 https://9h.hk，鉴权方式：请求头 Authorization: Bearer <API Key>
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/v1/shorten.php | 生成短链接（支持自定义短码；可选高级参数 password / max_clicks / expires_at / mobile_url / geo / utm） |
| GET | /api/v1/info.php?code={code} | 查询名下短链信息与点击量 |
| GET | /api/v1/usage.php | 查询本月配额与授权状态 |
| GET | /api/v1/health.php | 服务健康检查（公开） |
⚡快速开始
cURL 示例：
curl -X POST https://9h.hk/api/v1/shorten.php \
-H "Authorization: Bearer 9hk_你的APIKey" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/a/very/long/page"}'
# 成功返回
# {"code":0,"msg":"ok","data":{"short_url":"https://9h.hk/Ab3dEf",
# "code":"Ab3dEf","original":"https://example.com/a/very/long/page",
# "quota":{"used":1,"limit":1000,"remaining":999}}}
浏览器 JavaScript 示例（域名需先在授权白名单登记）:
const r = await fetch('https://9h.hk/api/v1/shorten.php', {
method: 'POST',
headers: {
'Authorization': 'Bearer 9hk_你的APIKey',
'Content-Type': 'application/json'
},
body: JSON.stringify({ url: 'https://example.com/page' })
});
const d = await r.json();
console.log(d.data.short_url);
服务端 PHP 示例：
$ch = curl_init('https://9h.hk/api/v1/shorten.php');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer 9hk_你的APIKey',
'Content-Type: application/json'
],
CURLOPT_POSTFIELDS => json_encode(['url' => 'https://example.com/page'])
]);
$d = json_decode(curl_exec($ch), true);
echo $d['data']['short_url'];💳收费与开通
API 提供免费自助档与付费套餐：免费档每月 100 条，登录后在个人中心自助开通；付费套餐按月调用配额、授权有效期、可登记域名数定价。开通流程：
登录本站账号，进入个人中心 ，在「API 密钥」区块点『免费开通』，密钥立即生成
复制密钥，按本页文档调用接口即可生成短链接
需要更高配额时，发邮件到 cp@9h.hk 说明用量，管理员为你升级套餐并可登记 IP 白名单
在个人中心可随时查看用量、轮换或停用密钥；配额与调用记录也可通过接口查询