短链接开放API，短网址API，API生成短网址接口-清酒短链接

API访问凭证

登录后可获取专属API调用凭证及完整接口权限

接口端点

v2.allup.com.cn/api/url.php

数据格式

JSON

请求方法

GET / POST

默认短链类型

1

企业级应用推荐使用POST方式

v2.allup.com.cn/api/url.php?type=dwz&pattern=1&token=your_enterprise_token&url=https://www.example.com

参数名称	是否必填	数据类型	参数说明
`type`	是	`string`	短网址类型标识，默认dwz为随机域名，指定type=1为企业专属域名
`url`	是	`string`	需要缩短的原始URL，需符合RFC 3986规范，支持HTTP/HTTPS协议
`token`	是	`string`	企业账号API访问凭证，用于接口身份验证
`pattern`	否	`string`	短网址访问模式：1-普通模式，2-防红模式，3-直链模式，4-企业超级防红模式
`title`	否	`string`	直链模式下显示的企业自定义标题，长度限制1-50字符
`bz`	否	`string`	企业内部备注信息，仅用于后台管理，不对外展示
`pwd`	否	`string`	访问密码，设置后需验证密码方可访问短链接，增强企业数据安全
`visit`	否	`string`	访问次数限制，企业可设置短链接最大访问次数，超出后失效
`visiturl`	否	`string`	超出访问次数后的跳转地址，企业可配置为提示页面或官网地址

成功响应

HTTP状态码200，code字段返回200表示接口调用成功，dwz字段返回生成的企业短网址

失败响应

HTTP状态码200，code字段返回非200数值，msg字段返回标准化错误信息，便于企业系统对接

参数名称	数据类型	参数说明
`code`	`string`	接口响应状态码，200表示调用成功，其他值表示调用失败
`msg`	`string`	响应描述信息，失败时返回标准化错误说明，便于企业问题定位
`dwz`	`string`	生成的企业短网址，仅在调用成功时返回该字段

{"code":200,"dwz":"https://v2.allup.com.cn/abcde"}

错误码	错误描述	解决方案
`201`	缺少URL参数	检查请求参数是否包含合规的url字段，确保传入有效的企业业务URL
`202`	API凭证无效	验证Token是否正确，确认企业账号状态正常，重新获取有效凭证
`205`	企业服务到期	联系企业客户经理续费API服务，或升级至更高版本的企业套餐
`210`	调用频率超限	优化企业调用逻辑，或联系客服申请提升API调用频率限制
`215`	URL内容违规	检查URL指向内容是否符合企业合规要求，修改后重新调用