FB Crawler API

Endpoint

POST/api/external/tasks

Header

Authorization: Bearer <API_TOKEN>
Content-Type: application/json

Request Body

字段	类型	必填	值
`fb_url`	string	是	Facebook URL
`obs`	boolean	否	`true` / `false`
`callback_url`	string	是	HTTP/HTTPS URL

Request Example

cURL

curl -X POST "https://fb-crawler.suxi-svc.com/api/external/tasks" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "fb_url": "https://www.facebook.com/example",
    "obs": true,
    "callback_url": "https://callback.example/facebook"
  }'

Response 200

JSON

{
  "task_id": "6687f9c3f4f7a0a2f4a19e01",
  "status": "queued",
  "fb_url": "https://www.facebook.com/example",
  "obs": true,
  "callback_url": "https://callback.example/facebook"
}

Callback Success

POST callback_url

{
  "event": "fb_crawler.task_done",
  "task_id": "6687f9c3f4f7a0a2f4a19e01",
  "status": "done",
  "fb_url": "https://www.facebook.com/example",
  "result_id": "6687fa30f4f7a0a2f4a19e02",
  "viewer_url": "https://fb-crawler.suxi-svc.com/viewer.html?file=/api/results/6687fa30f4f7a0a2f4a19e02/data",
  "result_data_url": "/api/results/6687fa30f4f7a0a2f4a19e02/data",
  "summary": {},
  "data": {},
  "finished_at": "2026-07-04T12:00:00+00:00"
}

Callback Failed

POST callback_url

{
  "event": "fb_crawler.task_failed",
  "task_id": "6687f9c3f4f7a0a2f4a19e01",
  "status": "failed",
  "fb_url": "https://www.facebook.com/example",
  "error": "失败原因",
  "finished_at": "2026-07-04T12:00:00+00:00"
}

Error Response

HTTP	Body
`401`	`{"detail":"Unauthorized"}`
`400`	`{"detail":"fb_url 必填"}`
`400`	`{"detail":"callback_url 必须是 http/https URL"}`