Bắt đầu
Luồng Yêu cầu
- Gửi một Nhiệm vụ
Gửi yêu cầu
POST
đến/api/v1/scraper/request
. - Xử lý Phản hồi
- HTTP 200 (Thành công): Dữ liệu được trả về trực tiếp trong nội dung phản hồi.
- HTTP 201 (Đang xử lý): Sử dụng
taskId
được cung cấp để kiểm tra kết quả.
- Kiểm tra Kết quả
Đối với các nhiệm vụ không đồng bộ, hãy liên tục gọi
/api/v1/scraper/result/{taskId}
cho đến khi dữ liệu sẵn sàng (HTTP 200).
Mã Trạng thái HTTP
Code | Ý nghĩa | Hành động |
---|---|---|
200 | Thành công | Sử dụng dữ liệu nội dung phản hồi trực tiếp. |
201 | Nhiệm vụ đang tiến hành | Kiểm tra /result/{taskId} (khoảng thời gian khuyến nghị: 1-5 giây). |
400 | Tham số không hợp lệ | Vui lòng kiểm tra xem các tham số nhiệm vụ có hợp lệ không. |
429 | Vượt quá giới hạn tốc độ | Giảm tần suất yêu cầu hoặc liên hệ hỗ trợ để điều chỉnh hạn ngạch. |
500 | Lỗi máy chủ nội bộ | Thử lại sau 1 phút; liên hệ hỗ trợ nếu vẫn còn lỗi. |
Ví dụ Mã
Luồng Hoàn chỉnh
import { ScrapelessClient, log } from '@scrapeless-ai/sdk';
const client = new ScrapelessClient({
apiKey: 'YOUR_API_KEY',
});
async function runTask() {
const result = await client.scraping.scrape({
{
actor: 'scraper.shopee',
input: {
url: 'https://shopee.tw/a-i.10228173.24803858474'
}
},
});
return result;
}
runTask()
.then(data => {
console.log('Data:', data);
})
.catch(error => {
console.error('Error:', error);
});
cURL (Ví dụ Kiểm tra)
curl --location --request GET 'https://api.scrapeless.com/api/v1/scraper/result/30681c8b-bfd3-48eb-a7c9-006e40b00591' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json'
Tham số
Tham số | Kiểu | Mô tả |
---|---|---|
actor | string | Dịch vụ scraping (ví dụ: scraper.shopee). |
input | object | Các tham số cụ thể của nhiệm vụ (ví dụ: action, url). |
proxy | object | Cấu hình proxy tùy chọn với trường quốc gia. |
Ghi chú
- Khuyến nghị Kiểm tra
- Khoảng thời gian: 1-5 giây.
- Thời gian chờ: Đặt giới hạn thử lại tối đa (ví dụ: 10 lần thử).
- Mẹo gỡ lỗi
- Thử nghiệm với các URL đơn giản trước.