将长链接转换为短链接，支持自定义短码和过期时间设置。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
long_url | string | 是 | 需要缩短的原始链接 |
custom_code | string | 否 | 自定义短码（4-10位字母数字） |
expire_at | timestamp | 否 | 过期时间戳 |
title | string | 否 | 链接标题备注 |
请求示例
curl -X POST 'https://api.lianyin.com/api/v1/links' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"long_url": "https://example.com/very/long/url",
"title": "示例链接"
}'
响应示例
{
"code": 0,
"message": "success",
"data": {
"short_url": "https://w1s.cc/abc123",
"short_code": "abc123",
"long_url": "https://example.com/very/long/url",
"created_at": "2024-01-15T10:30:00Z"
}
}
根据短码查询短链接的详细信息。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
code | string | 是 | 短链接编码 |
请求示例
curl -X GET 'https://api.lianyin.com/api/v1/links/abc123' \
-H 'Authorization: Bearer YOUR_API_KEY'
响应示例
{
"code": 0,
"message": "success",
"data": {
"short_url": "https://w1s.cc/abc123",
"short_code": "abc123",
"long_url": "https://example.com/very/long/url",
"title": "示例链接",
"clicks": 1234,
"created_at": "2024-01-15T10:30:00Z"
}
}
获取短链接的点击统计数据，包括访问量、地域分布等。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
code | string | 是 | 短链接编码 |
start_date | date | 否 | 统计开始日期 |
end_date | date | 否 | 统计结束日期 |
请求示例
curl -X GET 'https://api.lianyin.com/api/v1/links/abc123/stats?start_date=2024-01-01' \
-H 'Authorization: Bearer YOUR_API_KEY'
响应示例
{
"code": 0,
"message": "success",
"data": {
"total_clicks": 1234,
"unique_visitors": 890,
"daily_stats": [
{ "date": "2024-01-15", "clicks": 120 },
{ "date": "2024-01-14", "clicks": 98 }
],
"top_referrers": [
{ "source": "weixin", "count": 456 },
{ "source": "douyin", "count": 234 }
]
}
}
批量创建短链接，单次最多支持100条。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
links | array | 是 | 链接数组，每个元素包含long_url |
请求示例
curl -X POST 'https://api.lianyin.com/api/v1/links/batch' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"links": [
{ "long_url": "https://example.com/page1" },
{ "long_url": "https://example.com/page2" }
]
}'
响应示例
{
"code": 0,
"message": "success",
"data": {
"success_count": 2,
"results": [
{ "short_url": "https://w1s.cc/abc123", "long_url": "https://example.com/page1" },
{ "short_url": "https://w1s.cc/def456", "long_url": "https://example.com/page2" }
]
}
}
删除指定的短链接，删除后链接将不可访问。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
code | string | 是 | 短链接编码 |
请求示例
curl -X DELETE 'https://api.lianyin.com/api/v1/links/abc123' \
-H 'Authorization: Bearer YOUR_API_KEY'
响应示例
{
"code": 0,
"message": "success",
"data": null
}
