API 文档

短链接服务 API 提供了完整的短链创建、管理和统计功能。所有API端点均支持JSON格式的请求和响应。

基础URL: http://localhost:8000

认证方式

如果服务启用了API密钥认证,需要在请求中携带密钥:

HTTP Header

X-API-Key: your-api-key-here

或在URL中添加查询参数: ?api_key=your-api-key-here

API 端点

POST /api/shorten

创建一个新的短链接

url 必需

原始URL地址

custom_code 可选

自定义短码 (6-10个字符)

expires_in_hours 可选

过期时间(小时)

请求示例

{
  "url": "https://www.example.com/very/long/url",
  "custom_code": "my-link",
  "expires_in_hours": 24
}

响应示例

{
  "short_code": "my-link",
  "short_url": "http://localhost:8000/my-link",
  "original_url": "https://www.example.com/very/long/url",
  "created_at": "2024-01-01T12:00:00",
  "click_count": 0,
  "expires_at": "2024-01-02T12:00:00"
}

POST /api/shorten/batch

批量创建多个短链接

请求示例

{
  "urls": [
    "https://example.com/page1",
    "https://example.com/page2"
  ],
  "expires_in_hours": 24
}

GET /api/info/{short_code}

获取指定短链的详细信息

GET /api/stats/{short_code}

获取短链的访问统计

GET /api/list

获取所有短链列表(支持分页)

skip 可选

跳过的记录数,默认0

limit 可选

返回的最大记录数,默认100

DELETE /api/{short_code}

删除指定的短链

GET /{short_code}

访问短链,自动重定向到原始URL(无需API密钥)

认证方式

API 端点

管理员 API

更多资源