API（状态和账单信息）

API 端点

查询任务状态和账户信息的 API。

认证

在账户设置获取 API 密钥。使用以下请求头进行认证：

Authorization: Bearer YOUR_API_KEY

获取任务状态

请求

GET https://api.listly.io/v1/tasks/{task_id}

响应示例

响应示例 (application/json)

{
  "task_id": "abc123",
  "status": "completed",
  "progress": 100,
  "created_at": "2024-01-15T10:30:00Z",
  "completed_at": "2024-01-15T10:35:00Z",
  "urls_processed": 50,
  "urls_failed": 2,
  "data_url": "https://api.listly.io/v1/tasks/abc123/data"
}

状态值

pending - 等待中
processing - 处理中
completed - 已完成
failed - 失败
cancelled - 已取消

获取账户信息

请求

GET https://api.listly.io/v1/account

响应示例

响应示例 (application/json)

{
  "plan": "business",
  "urls_basic": "unlimited",
  "urls_advanced": 5000,
  "urls_advanced_used": 1234,
  "storage_used_mb": 450,
  "storage_limit_mb": 10000
}

获取任务列表

请求

GET https://api.listly.io/v1/tasks?limit=20&offset=0

查询参数

limit - 每页数量（最大100）
offset - 偏移量
status - 按状态过滤
from_date - 起始日期

错误处理示例与代码

错误响应示例

{
  "error": {
    "code": "task_not_found",
    "message": "Task with ID abc123 not found"
  }
}

常见错误代码

401 - 未授权
404 - 未找到
429 - 请求过多
500 - 服务器错误

速率限制

免费计划：100 请求/小时
付费计划：1000 请求/小时
企业版：自定义

API 端点

获取任务状态

获取账户信息

获取任务列表

相关文档