🔌
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 白名單
在個人中心可隨時查看用量、輪換或停用密鑰；配額與調用記錄也可通過接口查詢