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

Tài liệu dưới đây giúp bạn xây dựng request và phân tích mọi phản hồi mà API AI Scraper trả về.

Tham số chung

Tham số	Kiểu	Bắt buộc	Mô tả
`actor`	string	Có	Định danh cố định của mô hình cần chạy.
`webhook`	object	Không	Đối tượng cấu hình webhook tùy chọn.
`webhook.url`	string	Không	Endpoint HTTPS nhận kết quả sau khi hoàn thành.
`input`	object	Có	Tham số dành riêng cho actor (prompt, mode, country…).

Cấu trúc kết quả

Trường	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 khi thất bại.
`task_result`	object	Không	Payload chi tiết của actor; xem từng tài liệu mô hình để biết các trường cụ thể.

Payload webhook

Khi chỉ định webhook.url, Scrapeless sẽ gửi yêu cầu POST với JSON sau:

Trường	Kiểu	Bắt buộc	Mô tả
`task_id`	string	Có	Định danh tác vụ đã hoàn thành.
`status`	string	Có	`success` hoặc `failed`.
`input`	string	Có	Tham số gốc dưới dạng chuỗi JSON.
`task_result`	object	Không	Cùng cấu trúc với khi bạn truy vấn 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

Mã	Ý nghĩa
`200`	Lấy kết quả thành công.
`201`	Tạo tác vụ 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ệ; xem thông báo lỗi.
`410`	Kết quả đã hết hạn (lưu tối đa 12 giờ).
`429`	Quá giới hạn tần suất.

Bắt đầu ChatGPT