生成短链接 API
将原始长网址转换为短链接,可选择自定义短码和有效期。
| 接口路径 | /api/create |
|---|---|
| 请求方法 | POST |
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| longUrl | string | 是 | 需要缩短的 HTTP 或 HTTPS 原始网址。 |
| customCode | string | 否 | 6 至 12 位字母数字短码;留空时自动生成。 |
| expireDays | number | 否 | 有效期天数,默认 30 天,最大 365 天。 |
请求示例
{
"longUrl": "https://www.example.com/abc",
"customCode": "mycode123",
"expireDays": 30
}
返回示例
{
"status": 1,
"code": "mycode123",
"shortUrl": "https://883588.xyz/s/mycode123",
"expire": 1718889600000
}
status=1 表示生成成功,shortUrl 为可直接分享的短链接。
错误响应
请求参数、网址格式或自定义短码不符合要求时,接口会返回具体错误信息。
{
"status": 0,
"msg": "错误信息"
}