起司防红短链 · API 对接文档

一行代码，快速接入防红短链服务。
快速开始

1. 获取 API Key

登录用户中心 → 个人资料 → 复制你的 API Key（32位字符串）

2. 调用接口

http
POST https://u.74tx.com/api.php
参数必填说明
url✅要缩短的网址，如 https://example.com
api_key✅你的 API Key

3. 返回结果

成功：

json
{
  "code": 0,
  "msg": "生成成功",
  "dwz": "https://u.74tx.com/AbCdEf"
}

失败：

json
{
  "code": -1,
  "msg": "错误原因"
}
一行代码接入

PHP（file_get_contents）

php
$short = json_decode(file_get_contents('https://u.74tx.com/api.php?url='.urlencode($url).'&api_key=你的KEY'), true)['dwz'];

PHP（cURL 函数封装）

php
function dwz($url){return json_decode(file_get_contents('https://u.74tx.com/api.php?url='.urlencode($url).'&api_key=你的KEY'),true)['dwz'];}
// 使用：echo dwz('https://example.com');

Python

python
import requests; short = requests.post('https://u.74tx.com/api.php', data={'url': url, 'api_key': '你的KEY'}).json()['dwz']

JavaScript（浏览器端）

javascript
const short = await (await fetch('https://u.74tx.com/api.php', {method:'POST', headers:{'Content-Type':'application/x-www-form-urlencoded'}, body: `url=${encodeURIComponent(url)}&api_key=你的KEY`})).json().dwz;

Node.js

javascript
const short = await (await fetch('https://u.74tx.com/api.php', {method:'POST', headers:{'Content-Type':'application/x-www-form-urlencoded'}, body:`url=${encodeURIComponent(url)}&api_key=你的KEY`})).json().dwz;

cURL（命令行）

bash
curl -s "https://u.74tx.com/api.php" --data "url=https://example.com&api_key=你的KEY" | python -c "import sys,json;print(json.load(sys.stdin)['dwz'])"

Go

go
resp, _ := http.PostForm("https://u.74tx.com/api.php", url.Values{"url": {targetUrl}, "api_key": {"你的KEY"}})
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
short := result["dwz"].(string)

Java（OkHttp）

java
// OkHttp 一行调用
String shortUrl = new OkHttpClient().newCall(new Request.Builder().url("https://u.74tx.com/api.php").post(new FormBody.Builder().add("url",url).add("api_key","你的KEY").build()).build().execute().body().string()).body().string(); // 再 JSON 解析取 dwz
完整示例

PHP 完整函数（推荐）

php
<?php
function createShortLink($url, $apiKey = '你的APIKey') {
    $api = 'https://u.74tx.com/api.php';
    $resp = file_get_contents($api . '?url=' . urlencode($url) . '&api_key=' . $apiKey);
    $data = json_decode($resp, true);
    return $data['code'] === 0 ? $data['dwz'] : false;
}
// 使用
$short = createShortLink('https://example.com/very/long/url');
if ($short) { echo '短链：' . $short; } else { echo '生成失败'; }

Python 完整示例

python
import requests
def create_short_link(url, api_key='你的APIKey'):
    resp = requests.post('https://u.74tx.com/api.php', data={'url': url, 'api_key': api_key}).json()
    return resp['dwz'] if resp['code'] == 0 else None
# 使用
short = create_short_link('https://example.com')
print(f'短链：{short}' if short else '生成失败')

JavaScript 完整示例

javascript
async function createShortLink(url, apiKey = '你的APIKey') {
  const resp = await fetch('https://u.74tx.com/api.php', {
    method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
    body: `url=${encodeURIComponent(url)}&api_key=${apiKey}`
  });
  const data = await resp.json();
  return data.code === 0 ? data.dwz : null;
}
// 使用
const short = await createShortLink('https://example.com');
console.log(short ? `短链：${short}` : '生成失败');
可选参数
参数必填说明
url✅目标网址
api_key✅你的 API Key
domain❌指定短链域名（需在后台配置）
错误码
code含义解决方案
0成功读取 dwz 字段
-1参数错误 / 频率限制检查 URL 格式，稍后重试
-2匿名次数用完使用 api_key 调用
-3积分不足充值或升级会员
-4API Key 无效 / 账号禁用检查 Key 是否正确
计费规则
用户类型生成限制
匿名（不传 api_key）每日 10 次，单链限 100 次访问
普通用户每日有免费额度，超出扣积分
会员无限生成，无限访问
注意事项
API Key 请妥善保管，建议存放到环境变量或配置文件中，不要暴露在前端代码
URL 必须以 http:// 或 https:// 开头
支持浏览器端跨域调用（CORS 已开启）
如需重置 API Key，在用户中心操作，重置后旧 Key 立即失效