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 - 数据

• Webhook 集成