dwz.cn API 接口接入指南：企业级批量生成解决方案

? API 核心功能解析

• 批量生成：付费用户单次请求最多可处理 5 条长链接，大大提高了工作效率。比如电商企业在促销活动中，需要生成大量短链接用于短信营销或社交媒体推广，使用批量接口就能快速完成任务。
• 自定义域名：企业可以使用自己的域名（如 *.dwz.cn）生成短链接，增强品牌辨识度。例如，某科技公司使用 “tech.dwz.cn” 作为短链接域名，既专业又易于记忆。
• 有效期设置：支持设置短链接的有效期，包括长期有效和按天计算的短期有效。对于时效性强的活动链接，设置有效期可以避免资源浪费和潜在风险。
• 数据统计：虽然具体的数据分析接口参数未在搜索结果中详细说明，但dwz.cn作为专业的网址缩短平台，应该提供点击量、来源分布等基础统计功能，帮助企业评估推广效果。

?️ 接入准备与步骤详解

? 获取 Token

? 接入流程

1. 请求地址：使用 HTTPS 协议，请求地址为https://dwz.cn/api/v3/short-urls。
2. 请求头设置：必须包含Dwz-Token和Content-Type字段，其中Content-Type应设置为application/json; charset=UTF-8。
3. 请求参数：
   • LongUrl：需要缩短的长链接，必须以http(s)://开头。
   • TermOfValidity：短链接有效期，支持长期有效或按天设置。
   • CustomPath（可选）：自定义短链接的路径部分，如https://dwz.cn/abc123中的abc123。
   
   
4. 响应处理：成功响应会返回短链接信息，包括ShortUrl和Code（0 表示成功）。如果出现错误，ErrMsg字段会提示具体原因，如-10表示无效长网址，-13表示长网址可能存在安全风险。

? 代码示例（PHP）

$host = 'https://dwz.cn';
$path = '/api/v3/short-urls';
$url = $host . $path;
$method = 'POST';
$token = '你的Token';
$headers = array(
    'Content-Type: application/json; charset=UTF-8',
    'Dwz-Token: ' . $token
);

$bodys = array(
    'LongUrl' => 'https://www.example.com/long-url',
    'TermOfValidity' => '长期有效'
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($bodys));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
if ($data['Code'] === ) {
    echo '生成的短网址为：' . $data['ShortUrl'];
} else {
    echo '生成失败：' . $data['ErrMsg'];
}
?>

? 企业级批量处理优势

? 高效与稳定

? 安全与合规

• 数据安全：dwz.cn通过了 HTTPS 安全检测，传输安全等级合格，未发现常见漏洞和篡改情况。它还采用智能过滤技术，识别虚假流量，保护企业数据安全。
• 合规性：虽然未明确提及等保 2.0 或 GDPR 认证，但百度作为国内互联网巨头，其服务通常符合国内相关法规要求。企业用户在接入时，可进一步咨询官方获取详细的合规信息。

? 成本效益

? 应用场景与案例

? 短信营销

? 社交媒体推广

? 数据统计与分析

❓ 常见问题解答

1. 短链接的有效期如何设置？
   
   
   • 可以选择长期有效或按天设置，具体参数为TermOfValidity，如长期有效或30天。
   
   
2. 能否修改已生成的短链接？
   
   
   • 支持修改，但需注意一分钟内特定短网址仅可修改一次，且修改后可能因缓存机制延迟生效。
   
   
3. 如何处理长链接的安全风险？
   
   
   • dwz.cn会对长链接进行安全审核，若提示存在风险，可申请人工审核解决。
   
   
4. 是否支持批量删除短链接？
   
   
   • 目前搜索结果中未明确提及批量删除接口，建议通过官方文档或技术支持进一步确认。
   
   

? 总结