Chi tiết Vòng đời Tác vụ
Sử dụng tài liệu tham khảo sau để xây dựng các yêu cầu 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 tác vụ.
Các Tham số Yêu cầu Phổ biến
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
actor | string | Có | Định danh cố định cho biết mô hình 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 phản hồi cho actor. Xem tài liệu actor để biết chi tiết từng trường. |
Dữ liệu Gửi Webhook
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 tương tự như khi bạn thăm dò điểm cuối kết quả. |
Ví dụ Gử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ệ hoặc thực thi thất bại. 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. |