Chi tiết vòng đời tác vụ

Sử dụng phần tham chiếu sau để định hình các yêu cầu của bạn và diễn giải mọi phản hồi mà API AI Scraper trả về trong suốt vòng đời của một tác vụ.

Các tham số yêu cầu chung

Parameter	Type	Required	Description
`actor`	string	Có	Định danh cố định cho biết bạn muốn chạy mô hình nào.
`webhook`	object	Không	Đối tượng chứa các cài đặt webhook tùy chọn.
`webhook.url`	string	Không	Endpoint HTTPS nhận kết quả khi tác vụ hoàn tất.
`input`	object	Có	Các tham số riêng của actor như prompt, mode hoặc country.

Cấu trúc dữ liệu kết quả

Parameter	Type	Required	Description
`status`	string	Có	Trạng thái tác vụ: `pending`, `running`, `success`, hoặc `failed`.
`message`	string	Không	Thông báo lỗi nếu tác vụ thất bại.
`task_result`	object	Không	Payload đầy đủ cho actor. Xem tài liệu actor để biết chi tiết ở cấp độ trường.

Payload Webhook Push

Nếu bạn thiết lập webhook.url, Scrapeless sẽ gửi một yêu cầu POST với cấu trúc JSON sau:

Parameter	Type	Required	Description
`task_id`	string	Có	Định danh của tác vụ đã hoàn thành.
`status`	string	Có	`success` hoặc `failed`.
`input`	string	Có	Các tham số tác vụ gốc được tuần tự hóa dưới dạng JSON.
`task_result`	object	Không	Cấu trúc giống như khi bạn poll endpoint kết quả.

Ví dụ Push

curl --location '{webhook.url}' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "",
    "status": "",
    "input": "",
    "task_result": {}
  }'

Mã trạng thái HTTP

Status	Meaning
`200`	Thành công. Kết quả đã được truy xuất.
`201`	Tác vụ được tạo thành công.
`202`	Tác vụ vẫn đang chạy—hãy thử lại sớm.
`400`	Yêu cầu không hợp lệ. Kiểm tra thông báo lỗi để biết chi tiết.
`410`	Kết quả tác vụ đã hết hạn. Kết quả vẫn khả dụng trong 12 giờ.
`429`	Vượt quá giới hạn tốc độ. Giảm tần suất yêu cầu hoặc nâng cấp dung lượng.

Bắt đầu ChatGPT