短链接 API

GET /api/v1/links

curl -X GET "https://like.do/api/v1/links?page=1&limit=10&sortBy=clicks&sortOrder=desc" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "abc123xyz",
        "slug": "example",
        "targetUrl": "https://example.com",
        "domain": "ig.do",
        "shortUrl": "https://ig.do/example",
        "description": "示例链接",
        "tag": "营销",
        "clicks": 42,
        "active": true,
        "visible": false,
        "expiration": "-1",
        "createdAt": "2026-01-04T12:00:00.000Z",
        "updatedAt": "2026-01-04T12:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 25,
      "totalPages": 3
    }
  }
}

POST /api/v1/links

{
  "slug": "my-link",
  "targetUrl": "https://example.com",
  "domain": "ig.do",
  "visible": false,
  "active": true,
  "expiration": "-1",
  "password": "123456",
  "description": "我的短链接",
  "tag": "营销"
}

curl -X POST https://like.do/api/v1/links \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "example",
    "targetUrl": "https://example.com",
    "domain": "ig.do"
  }'

{
  "success": true,
  "data": {
    "id": "abc123xyz",
    "slug": "example",
    "targetUrl": "https://example.com",
    "domain": "ig.do",
    "shortUrl": "https://ig.do/example",
    "visible": false,
    "active": true,
    "expiration": "-1",
    "createdAt": "2026-01-04T12:00:00.000Z"
  }
}

{
  "success": false,
  "error": "您已达到免费计划的每月 50 个链接限制。升级到专业版可获得每月 1,000 个链接，或终身版可获得无限链接。",
  "quota": {
    "planType": "free",
    "currentCount": 50,
    "limit": 50,
    "remaining": 0
  }
}

GET /api/v1/links/{id}

curl -X GET https://like.do/api/v1/links/abc123xyz \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "id": "abc123xyz",
    "slug": "example",
    "targetUrl": "https://example.com",
    "domain": "ig.do",
    "shortUrl": "https://ig.do/example",
    "description": "示例链接",
    "tag": "营销",
    "clicks": 42,
    "active": true,
    "visible": false,
    "expiration": "-1",
    "createdAt": "2026-01-04T12:00:00.000Z",
    "updatedAt": "2026-01-04T12:00:00.000Z"
  }
}

PUT /api/v1/links/{id}

{
  "targetUrl": "https://new-example.com",
  "description": "更新后的描述",
  "tag": "更新标签",
  "active": true,
  "visible": false,
  "password": "newpwd",
  "expiration": "-1"
}

curl -X PUT https://like.do/api/v1/links/abc123xyz \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "targetUrl": "https://new-example.com",
    "description": "更新后的链接"
  }'

{
  "success": true,
  "data": {
    "id": "abc123xyz",
    "updatedAt": "2026-01-04T13:00:00.000Z"
  }
}

{
  "success": false,
  "error": "Missing API key. Provide it via Authorization header (Bearer token) or ?key= query parameter"
}

{
  "success": false,
  "error": "Invalid or expired API key: [error details]"
}

{
  "success": false,
  "error": "Invalid request data",
  "details": [
    {
      "path": ["slug"],
      "message": "Slug must be at least 3 characters"
    }
  ]
}

{
  "success": false,
  "error": "You don't have permission to use the domain \"kfc.sh\". Premium domains require an active Pro subscription or Lifetime plan."
}

{
  "success": false,
  "error": "Link not found or access denied"
}

{
  "success": false,
  "error": "A link with this slug already exists"
}

// 创建链接
const response = await fetch('https://like.do/api/v1/links', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    slug: 'example',
    targetUrl: 'https://example.com',
    domain: 'ig.do',
  }),
});

const data = await response.json();
console.log(data);

// 获取链接详情
const linkId = data.data.id;
const getResponse = await fetch(`https://like.do/api/v1/links/${linkId}`, {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
  },
});

const linkData = await getResponse.json();
console.log(linkData);

// 更新链接
const updateResponse = await fetch(`https://like.do/api/v1/links/${linkId}`, {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    description: '更新后的描述',
  }),
});

const updateData = await updateResponse.json();
console.log(updateData);

import requests

api_key = 'YOUR_API_KEY'
base_url = 'https://like.do/api/v1/links'
headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json',
}

# 创建链接
data = {
    'slug': 'example',
    'targetUrl': 'https://example.com',
    'domain': 'ig.do',
}
response = requests.post(base_url, headers=headers, json=data)
print(response.json())

# 获取链接详情
link_id = response.json()['data']['id']
get_response = requests.get(f'{base_url}/{link_id}', headers=headers)
print(get_response.json())

# 更新链接
update_data = {
    'description': '更新后的描述',
}
update_response = requests.put(f'{base_url}/{link_id}', headers=headers, json=update_data)
print(update_response.json())

# 获取链接列表
list_response = requests.get(f'{base_url}?page=1&limit=10', headers=headers)
print(list_response.json())