短网址生成免费API接口详解

原创于 2025-06-29 15:11:41 发布 · 843 阅读

3 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

一、接口简介

提供网页地址转短链接服务，特点如下：

永久有效：生成的短链接长期可用
访问统计：支持通过专用接口查询访问数据
安全规范：严禁跳转违法违规网页
免费使用：无每日调用次数限制（独享ID/KEY可避免频次限制）

二、请求说明

要素	详情
请求地址	`https://cn.apihz.cn/api/wangzhan/dwz1.php`
请求方式	GET 或 POST
编码要求	若URL含`&`需替换为`<>`（最大长度1000字符）

请求参数：

参数名	必填	说明
`id`	是	用户ID（用户中心获取的数字ID）
`key`	是	通讯秘钥（用户中心获取）
`url`	是	需转换的长网址（需URL编码）
`type`	否	主域类型： `1`=00l.xyz `2`=l00.xyz 默认随机

三、返回参数

字段	说明
`code`	状态码： `200`=成功 `400`=失败
`msg`	错误提示（仅code=400时返回）
`ucode`	短网址后缀（5-7位字符，优先生成短后缀）
`domain`	短网址主域名
`dwz`	完整的短网址

成功响应示例：

json

复制

{
  "code": 200,
  "ucode": "aDRoh",
  "domain": "oo1.xyz",
  "dwz": "https://oo1.xyz/aDRoh"
}

失败响应示例：

json

复制

{
  "code": 400,
  "msg": "通讯秘钥错误"
}

四、调用示例（Python）

python

运行

复制

import requests

# 配置参数（需替换实际ID/KEY）
params = {
    "id": "10000000",          # 用户中心ID
    "key": "15he5h15ty854j5sr152hs2",  # 通讯秘钥
    "url": "https://www.example.com/article?page=1<>sort=desc",  # 注意&替换成<>
    "type": "1"                # 指定主域类型（可选）
}

# 发送GET请求
response = requests.get(
    url="https://cn.apihz.cn/api/wangzhan/dwz1.php",
    params=params
)

# 处理响应
if response.status_code == 200:
    data = response.json()
    if data["code"] == 200:
        print("短网址生成成功:", data["dwz"])
    else:
        print("错误:", data["msg"])
else:
    print("请求失败，状态码:", response.status_code)

标签

#android #数据库 #python #php #java