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

Sử dụng tài liệu tham khảo 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

Tham số	Kiểu	Bắt buộc	Mô tả
`actor`	string	Có	Định danh cố định cho biết mô hình nào bạn muốn chạy.
`webhook`	object	Không	Đối tượng chứa các cài đặt webhook tùy chọn.
`webhook.url`	string	Không	Điểm cuối HTTPS nhận kết quả khi tác vụ hoàn tất.
`input`	object	Có	Các tham số dành riêng cho actor như prompt, chế độ hoặc quốc gia.

Cấu trúc Dữ liệu Kết quả

Tham số	Kiểu	Bắt buộc	Mô tả
`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	Toàn bộ dữ liệu cho actor. Xem tài liệu của actor để biết chi tiết cấp trường.

Dữ liệu Webhook Gửi đi

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 như sau:

Tham số	Kiểu	Bắt buộc	Mô tả
`task_id`	string	Có	Định danh của tác vụ đã hoàn tất.
`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 truy vấn endpoint kết quả.

Ví dụ Gửi đi

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

Mã Trạng thái HTTP

Trạng thái	Ý nghĩa
`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 sau.
`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.
`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