短链接

响应数据以及返回码说明

侯小猴
发布于 2024-08-09 01:24:01

响应数据格式

数据接口响应均为 json 数据格式,并配合 HTTP 响应状态码来表示接口调用是否成功,返回的 json 数据格式说明如下:

{
	"code": 0, // 返回码,参考下文
	"message": "错误信息", // 参考下文
	"data": {} // 返回的数据对象
}

返回码以及 HTTP 状态码说明

返回码(code)错误信息(message)具体错误描述或解决方法HTTP状态码
0请求成功-
200
1请求头错误请检查Content-Type是否为application/json400
2请求数据格式错误请检查请求主体是否为有效的json字符串400
3请求参数缺失请按接口说明补充必须传入的参数400
4请求参数数据类型错误请按接口说明修改参数的数据类型400
11链接分组sid错误请参考获取链接分组接口返回的数据,传入正确的分组sid400
12跳转链接的格式错误请检查跳转链接是否是以 http:// 或者 https:// 开头的链接或应用跳转链接,是否符合 URL 语法400
13跳转链接的域名不在白名单之内请在 API 设置 里,将想要跳转的域名添加到白名单中403
14一天内短链接创建数量超过限制超过了每日调用接口创建链接数的限制,请 升级API套餐 获取更高额度403
15自定义域名未绑定或不可用请在 自定义域名设置 里绑定并启用想要使用的域名,如果想在协作空间下使用自定义域名,绑定了域名的账号还需要将域名应用到正确的协作空间中403
16短链接的格式错误请按正确的格式传入短链接URL400
17短链接无效没有找到符合查询条件的短链接400
18禁止循环跳转跳转链接与短链接的URL不可以相同400
19日期格式错误请按“yyyy-mm-dd”的格式传入日期400
20日期跨度无效查询日期区间的长度不能超过31天400
21offset/limit超出取值范围offset 不能小于0;limit 须大于0且不大于1000400
22场景值长度超出限制场景值的长度不能超过128个字符400
101apikey错误传入的 apikey 不正确401
102账号异常账号状态异常,请联系客服401
103没有API权限账号没有开通API权限401
104没有此API的调用权限账号没有此API的调用权限,请 升级API套餐 获取更多的开放API功能401
-1系统错误系统出现未知异常,请联系客服500
-2系统繁忙请稍候重试503
小码至营logo