Xác định nguyên nhân yêu cầu thất bại
Kiểm tra trạng thái HTTP, mã lỗi và nội dung phản hồi, sau đó đối chiếu phiên bản API, proxy và phiên kết nối trước khi tiếp tục.

Tra cứu mã lỗi
31 mã lỗi chính thức và 9 ví dụ bổ sung hướng dẫn, được sắp xếp theo loại lỗi. Các đề xuất xử lý cần được kết hợp với phiên bản và thông điệp thực tế.
Không tìm thấy kết quả phù hợp. Giữ mã thực tế và tin nhắn,Xem tài liệu phản hồi mới nhấthoặcLiên hệ hỗ trợ kỹ thuật。
Tham số và tài khoản
| Mã lỗi/Nguồn tài liệu | Đề xuất khắc phục sự cố | Bước tiếp theo |
|---|---|---|
PARAMS_ERRORTất cả các phiên bảntài liệu phản hồi | Kiểm tra các trường, loại và phạm vi bị thiếu, sửa bằng tin nhắn; giá trị thời gian chờ không hợp lệ trong V2 cũng có thể gây ra lỗi này. | Sửa cấu hình |
USER_AGENT_INVALIDv1/v2/v2stài liệu phản hồi | Trước tiên, hãy xóa x-cb-ua chưa được giải quyết hoặc quay lại dấu vân tay mặc định và kiểm tra phiên bản hiện tại của phạm vi hỗ trợ UA. | Sửa cấu hình |
APIKEY_INVALIDTất cả các phiên bảntài liệu phản hồi | Xác nhận rằng môi trường hoạt động thực tế đã đọc khóa hợp lệ, kiểm tra trạng thái bị tắt hoặc đặt lại và không giải quyết bằng cách thay đổi IP. | Dừng thử lại |
INSUFFICIENT_BALANCETất cả các phiên bảntài liệu phản hồi | Truy vấn số dư điểm API và thời gian hết hạn; lưu lượng proxy là một cách sử dụng khác và không thể thay thế lẫn nhau. | Dừng thử lại |
HOSTNAME_IS_FORBIDDENTất cả các phiên bảntài liệu phản hồi | Kiểm tra tên miền mục tiêu và quyền truy cập, đồng thời lưu giữ tin nhắn; đừng cố gắng phá vỡ các hạn chế truy cập rõ ràng. | Xác nhận thủ công |
HOSTNAME_IS_NULLTất cả các phiên bảntài liệu phản hồi | Hoàn thành x-cb-host, chỉ điền tên máy chủ mục tiêu và các cổng cần thiết, không có tham số giao thức, đường dẫn hoặc truy vấn. | Sửa cấu hình |
HOSTNAME_IS_INVALIDXác nhận bằng lợi nhuận thực tếBổ sung hướng dẫn AI | Kiểm tra máy chủ và cổng đích, giữ đường dẫn và tham số truy vấn trong URL yêu cầu API. | Sửa cấu hình |
PART_ERRORXác nhận bằng lợi nhuận thực tếBổ sung hướng dẫn AI | Kiểm tra định dạng số nguyên của x-cb-part và phạm vi khả dụng thực tế của tài khoản, đồng thời không sử dụng lại ngẫu nhiên các phân vùng cho các tác vụ khác. | Sửa cấu hình |
INVALID_SITEKEYXác nhận bằng lợi nhuận thực tếBổ sung hướng dẫn AI | Kiểm tra khóa trang web Turnstile của mục tiêu và xác nhận rằng yêu cầu cũng chứa trình giữ chỗ [cf_token]. | Sửa cấu hình |
Proxy, mạng và chứng chỉ
| Mã lỗi/Nguồn tài liệu | Đề xuất khắc phục sự cố | Bước tiếp theo |
|---|---|---|
PROXY_ERRORTất cả các phiên bảntài liệu phản hồi | Kiểm tra tài khoản proxy, giao thức, cổng, khoảng thời gian khả dụng và lưu lượng truy cập, đồng thời phân biệt các lỗi do proxy trả về với các lỗi do trang đích trả về. | Kiểm tra liên kết |
PROXY_FORMAT_ERRORTất cả các phiên bảntài liệu phản hồi | Kiểm tra định dạng proxy theo tài liệu tham số yêu cầu và xác nhận rằng phiên bản được sử dụng chấp nhận giao thức; viết lại tiền tố không có nghĩa là chuyển đổi giao thức. | Sửa cấu hình |
PROXY_IS_FORBIDDENTất cả các phiên bảntài liệu phản hồi | Xác nhận rằng dịch vụ có thể sử dụng địa chỉ proxy và thay vào đó hãy sử dụng proxy hợp lệ, được phép; không gửi cùng một địa chỉ bị cấm nhiều lần. | Dừng thử lại |
CONNECTION_ERRORTất cả các phiên bảntài liệu phản hồi | Phân biệt kết nối từ máy cục bộ đến API, API với tác nhân và mục tiêu, đồng thời kiểm tra địa chỉ và đường dây dựa trên thông báo. | Kiểm tra liên kết |
DNS_ERRORTất cả các phiên bảntài liệu phản hồi | Trước tiên, hãy xác nhận xem tên miền bị lỗi là tên miền API cục bộ, tên miền proxy hay tên miền mục tiêu, đồng thời kiểm tra độ phân giải và thời gian chờ tương ứng. | Kiểm tra liên kết |
TLS_ERRORTất cả các phiên bảntài liệu phản hồi | Kiểm tra các giao thức đích và proxy, thời gian hệ thống và chuỗi chứng chỉ; sửa lỗi không tắt xác minh TLS làm mặc định. | Kiểm tra liên kết |
CERT_ERRORTất cả các phiên bảntài liệu phản hồi | Kiểm tra chuỗi chứng chỉ, chứng chỉ trung gian proxy và địa chỉ đích; không chỉ đơn giản quy lỗi chứng chỉ cho các vấn đề về IP. | Kiểm tra liên kết |
REQUEST_ERRORTất cả các phiên bảntài liệu phản hồi | Hết thời gian chờ, bị từ chối và gián đoạn kết nối được phân biệt bằng thông báo và chỉ những lỗi tạm thời có thể phát lại an toàn mới có số lần thử lại hạn chế. | Số lần thử lại có giới hạn |
EOF_ERRORTất cả các phiên bảntài liệu phản hồi | Kiểm tra xem kết nối có bị đóng sớm hay không, proxy đã hết hạn hay chưa, tệp đã hoàn tất chưa và không coi các phản hồi bị cắt ngắn là thành công. | Kiểm tra liên kết |
RESOLVE_PROXYXác nhận bằng lợi nhuận thực tếBổ sung hướng dẫn AI | Kiểm tra DNS của máy chủ proxy với môi trường hoạt động thực tế và ghi lại thông báo lỗi phân giải. | Kiểm tra liên kết |
PROXY_CONNECT_ABORTEDXác nhận bằng lợi nhuận thực tếBổ sung hướng dẫn AI | Kiểm tra xác thực proxy, thời hạn hiệu lực và lý do gián đoạn kết nối, đồng thời chỉ thử lại trong phạm vi ngân sách sau khi bị lỗi tạm thời. | Kiểm tra liên kết |
TIMEOUT_ERRORXác nhận bằng lợi nhuận thực tếBổ sung hướng dẫn AI | Phân biệt giữa thời gian chờ của máy khách, thời gian chờ API và phản hồi mục tiêu, đồng thời xác nhận tổng ngân sách nhiệm vụ trước khi tăng thời gian chờ. | Kiểm tra thời gian chờ |
SSL_ERRORXác nhận bằng lợi nhuận thực tếBổ sung hướng dẫn AI | Kiểm tra chuỗi và giao thức chứng chỉ đích, proxy và ứng dụng khách, đồng thời không tắt xác minh chứng chỉ theo mặc định. | Kiểm tra liên kết |
Xác minh và phiên kết nối
| Mã lỗi/Nguồn tài liệu | Đề xuất khắc phục sự cố | Bước tiếp theo |
|---|---|---|
UNSUPPORTED_CAPTCHATất cả các phiên bảntài liệu phản hồi | Giữ nguyên loại xác minh và phản hồi giải mẫn cảm, liên hệ với bộ phận hỗ trợ kỹ thuật sau khi xác nhận ranh giới hỗ trợ và không thử lại vô thời hạn. | Dừng thử lại |
CLOUDFLARE_PREMIUMv1tài liệu phản hồi | Tài liệu liệt kê các mẹo dành cho V1 khi gặp tấm chắn năm giây; chuyển sang V2 sau khi xác minh mục tiêu và chuẩn bị cho các proxy cố định hoặc cố định. | Điều chỉnh phiên bản |
CLOUDFLARE_CHALLENGE_TIMEOUTv2tài liệu phản hồi | Kiểm tra độ ổn định đầu ra, tính hợp lệ của proxy và thời gian chờ hai tầng; thử lại bằng ngân sách và xác minh bằng các phiên mới nếu cần. | Số lần thử lại có giới hạn |
DATADOME_CHALLENGE_TIMEOUTv2tài liệu phản hồi | Kiểm tra các proxy cố định/dính và ngân sách thời gian thử thách; các lỗi liên tục giữ lại ID yêu cầu và thành công mà không gây ra sự chậm trễ. | Số lần thử lại có giới hạn |
DATADOME_ACCESS_DENIEDv2tài liệu phản hồi | Kiểm tra các quyền mục tiêu, khu vực và danh tiếng xuất khẩu; thay đổi mức xuất khẩu được phép dựa trên cơ sở và đồng thời thiết lập lại phiên. | Xác nhận thủ công |
CHALLENGE_LOCK_TIMEOUTv2tài liệu phản hồi | Kiểm tra xem có còn thử thách nào đang chờ trong cùng một phiên không; khóa chờ không được dùng nữa trong tài liệu tham số hiện tại. | Xếp hàng đầu tiên |
CHALLENGE_LOCK_OCCUPIEDv2tài liệu phản hồi | Đợi thử thách đầu tiên của cùng phiên kết thúc để giảm tính đồng thời; nhiệm vụ độc lập sử dụng phân vùng có sẵn độc lập. | Xếp hàng đầu tiên |
BYPASS_ERRORv2tài liệu phản hồi | Trước tiên hãy đọc tin nhắn và tập trung kiểm tra xem tác nhân có bị thay đổi trong phiên hay không; trước tiên hãy tạo phiên mới và lực lượng không được sử dụng làm cấu hình mặc định. | Kiểm tra phiên |
PROXY_NON_STICKYv2tài liệu phản hồi | Việc kiểm tra này chỉ dành cho proxy Scrapingbypass API. Thay vào đó, hãy sử dụng lối thoát được ghim/dính hợp lệ và tạo phiên xác thực mới. | proxy sửa chữa |
INCAPSULA_ACCESS_DENIEDXác nhận bằng lợi nhuận thực tếBổ sung hướng dẫn AI | Xác minh các giấy phép, khu vực và hoạt động xuất khẩu mục tiêu dựa trên các lý do bị từ chối thực tế; giữ lại bằng chứng để xác nhận tính tương thích của mục tiêu. | Xác nhận thủ công |
Giới hạn của trang đích và lỗi dịch vụ
| Mã lỗi/Nguồn tài liệu | Đề xuất khắc phục sự cố | Bước tiếp theo |
|---|---|---|
FORBIDDENTất cả các phiên bảntài liệu phản hồi | Trước tiên hãy kiểm tra quyền mục tiêu, trạng thái đăng nhập và nội dung phản hồi; chỉ xem xét V2 nếu có lời nhắc thử thách rõ ràng và không coi tất cả 403 là xác thực. | Xác nhận thủ công |
ACCESS_DENIEDTất cả các phiên bảntài liệu phản hồi | Kiểm tra các khu vực được phép, quyền tài khoản và danh tiếng xuất khẩu của mục tiêu, đồng thời lưu giữ bằng chứng cụ thể về việc từ chối truy cập. | Xác nhận thủ công |
TOO_MANY_REQUESTSTất cả các phiên bảntài liệu phản hồi | Trước tiên, hãy giảm thiểu sự đồng thời và tuân thủ quy trình Thử lại sau hiệu quả, kiểm tra hạn mức tài khoản và trang web, đồng thời không dựa vào việc thay đổi IP để xử lý giới hạn hiện tại theo mặc định. | Lùi lại và chờ đợi |
BAD_GATEWAYTất cả các phiên bảntài liệu phản hồi | Phân biệt giữa proxy, cổng và nguồn gốc mục tiêu, đồng thời ghi lại thời gian lỗi và ID yêu cầu; những lỗi tạm thời có thể được lùi lại và thử lại một cách an toàn. | Số lần thử lại có giới hạn |
SERVICE_UNAVAILABLETất cả các phiên bảntài liệu phản hồi | Kiểm tra xem mục tiêu hoặc cổng có tạm thời không khả dụng hay không; kiểm soát thử lại theo thời hạn và phản hồi sau khi thất bại liên tục. | Số lần thử lại có giới hạn |
SOURCE_SERVER_ERRORTất cả các phiên bảntài liệu phản hồi | Kiểm tra phản hồi lỗi của trang gốc và không sửa đổi nhiều lần các tham số không liên quan; giữ lại trạng thái, thời gian và ID yêu cầu. | Số lần thử lại có giới hạn |
INTERNAL_ERRORTất cả các phiên bảntài liệu phản hồi | Giữ ID yêu cầu, thời gian và phản hồi giải mẫn cảm được trả về bởi Scrapingbypass API; nếu nó tiếp tục xảy ra, hãy chuyển nó cho bộ phận hỗ trợ kỹ thuật. | hỗ trợ phản hồi |
GATEWAY_TIMEOUTXác nhận bằng lợi nhuận thực tếBổ sung hướng dẫn AI | Xác định xem đó là cổng cục bộ, proxy hay ngược dòng và đợi thời gian chờ, sau đó thử lại để phát hiện các lỗi tạm thời an toàn và có thể lặp lại. | Số lần thử lại có giới hạn |
Nguồn:dữ liệu phản hồi、Chẩn đoán lỗi truy cập AI. Các lỗi không xác định vẫn giữ nguyên giá trị ban đầu và không được phân loại thống nhất là "Thay đổi IP".
Giữ bằng chứng đầu tiênQuyết định xem có nên thử lại không
01. Có phản hồi HTTP không?
Nếu không có phản hồi, trước tiên hãy kiểm tra môi trường hoạt động, DNS, mạng, chứng chỉ và thời gian chờ của máy khách. Đừng tạo ra mã lỗi máy chủ.
02. Đọc hai cấp độ kết quả
x-cb-status: ok có nghĩa là yêu cầu API được xử lý thành công; trạng thái mục tiêu, Loại nội dung và nội dung doanh nghiệp vẫn phải được kiểm tra.
03. Giữ các trường lỗi
Lỗi API JSON sử dụng id, mã, tin nhắn. SDK có thể đưa ra một ngoại lệ, cần phải đọc phản hồi thực tế.
04. Chỉ thử lại các yêu cầu an toàn để phát lại
Dừng do lỗi cấu hình, số dư không đủ và không có quyền rõ ràng. Thời gian chờ đợi có giới hạn đối với những sai sót tạm thời; các hoạt động có tác dụng phụ trước tiên xác nhận tính bình thường hoặc kết quả thực hiện cuối cùng.
cấu trúc phản hồi lỗi
{
"id": "<request-id>",
"code": "PARAMS_ERROR",
"message": "<error-message>"
}Giá trị trường mang tính chất tham khảo; giữ phản hồi thực tế khi khắc phục sự cố và không sử dụng các ví dụ để che đậy các lỗi ban đầu.
| Tình hình quan sát | Ưu tiên phán xét |
|---|---|
| 200/HTML | Nó có thể là nội dung mục tiêu, nó có thể là trang đăng nhập hoặc trang xác minh; kiểm tra các lĩnh vực kinh doanh đầu tiên. |
| 403 | Kết hợp tiêu đề và nội dung phản hồi để phân biệt các thách thức, quyền tài khoản và các hạn chế theo khu vực. |
| 429 | Kiểm tra giới hạn hiện tại và Thử lại sau trước để giảm tính đồng thời. |
| 5xx | Phân biệt giữa cổng cục bộ, proxy, nguồn đích và lỗi do API trả về. |

Phiên bản, proxy và PhiênCần cùng nhau kiểm tra
01. Cookies và các bộ phận không trộn lẫn
Chế độ cookie được khách hàng lưu và gửi cookie xác minh được mã hóa; Chế độ phần được lưu trữ bởi máy chủ. Phiên xác minh bộ phận được giữ lại trong 10 phút, trong thời gian đó các yêu cầu thành công có thể được gia hạn nhưng thời hạn hiệu lực của proxy sẽ không được gia hạn.
02. Phiên xây dựng lại sau khi xuất thay đổi
Giữ IP, dấu vân tay và proxy nhất quán trong suốt thử thách; sử dụng phiên Phần hoặc Cookie mới sau khi thay đổi lối thoát và không chuyển đổi proxy đồng thời trong cùng một phân vùng.
03. Khóa phiên được xếp hàng đầu tiên
Thử thách đầu tiên kiểm soát hoạt động đồng thời trên cơ sở mỗi phiên. Chờ hoặc cách ly các tác vụ độc lập khi khóa bị chiếm và khóa bỏ qua và lực lượng không được sử dụng theo mặc định để bỏ qua các ràng buộc phiên.
Phiên bản giao diện, proxy và kiểm tra thời gian chờ
| phiên bản | Yêu cầu và phiên | x-cb-timeout |
|---|---|---|
| V1 | Nó đi kèm với một proxy động theo mặc định; mỗi yêu cầu là không trạng thái. x-cb-proxy có thể được cấu hình theo yêu cầu. | Mặc định là 30 giây; 5–3600 giây cho Go V1. Các giá trị không hợp lệ có thể bị bỏ qua. |
| V2 | x-cb-version: 2; Phải cung cấp proxy cố định hoặc có giới hạn thời gian, chọn chế độ Cookie hoặc Phần. | Mặc định là 15 giây; Python V2 hiện tại là 5–360 giây và các giá trị không hợp lệ trả về PARAMS_ERROR. |
| V2s | x-cb-version: 2 giây; tuân theo các yêu cầu về proxy và phiên V2, hỗ trợ truyền phát phản hồi HTTP. | Mặc định là 30 giây; khoảng 5–3600 giây. Khách hàng vẫn cần phải cấu hình ngân sách chờ đợi của riêng mình. |
Cấu hình yêu cầu khó hiểu
| Cấu hình | Những điều cần kiểm tra |
|---|---|
| URL và x-cb-host | URL API giữ lại đường dẫn đích và các tham số truy vấn; x-cb-host điền tên máy chủ đích và các cổng cần thiết, nhưng không điền giao thức hoặc đường dẫn. |
| x-cb-protocol | Được đặt rõ ràng thành http khi mục tiêu là HTTP; mặc định là https nếu không được đặt. |
| x-cb-proxy | Đây là lối thoát khi dịch vụ API truy cập vào mục tiêu và không tương đương với việc định cấu hình proxy cho máy khách HTTP cục bộ. Kiểm tra chứng nhận, thỏa thuận, tính sẵn có và độ ổn định xuất khẩu. |
| x-cb-part | Chỉ V2/V2; phạm vi mặc định của tài liệu là số nguyên 0–998, phạm vi thực tế tùy thuộc vào các giới hạn dịch vụ. Cô lập các phân vùng cho các nhiệm vụ khác nhau. |
| x-cb-sitekey | Turnstile cần được cung cấp phần giữ chỗ [cf_token] hoặc %5Bcf_token%5D; Truy vấn JS không yêu cầu điền sitekey. |
| x-cb-fp / x-cb-ua | Kiểm tra dấu vân tay của phiên bản thực tế dựa trên hành vi của UA. Hiện tại Python V2 bỏ qua x-cb-ua và không ghép ngẫu nhiên số phiên bản trình duyệt. |
| Chuyển hướng và tùy chọn cấu hình | Chuyển hướng được xử lý theo mặc định; xem tắt-redirect nếu bạn cần kiểm tra 3xx và Set-Cookie. khóa chờ không được dùng nữa, khóa bỏ qua và lực lượng không được sử dụng làm bản vá mặc định. |
| Hết thời gian chờ và thử lại | x-cb-timeout hợp lệ được ưu tiên hơn thời gian chờ lâu. Thời hạn của máy khách, SDK, proxy và nhiệm vụ được kiểm tra riêng biệt để tránh sự chồng chất của nhiều lớp thử lại tự động. |
Có sự khác biệt trong mô tả giao thức proxy trên trang tham số và trang phản hồi, cần được xác minh dựa trên phiên bản được sử dụng và thông báo thực tế; các trường hoàn chỉnh, phạm vi có sẵn và sự khác biệt khi triển khai như sauTài liệu tham số yêu cầu mới nhấtsẽ chiếm ưu thế.
V2s là phản hồi phát trực tuyến, không phải là tác vụ nền chính thức, giao diện bỏ phiếu hoặc gọi lại. Nội dung tải xuống phải kiểm tra trạng thái đích, loại nội dung và tính toàn vẹn; cả 200 và sự tồn tại của tệp đều không đủ để chứng minh thành công.
Tài liệu và dụng cụ, tìm lối vào bằng câu hỏi
Bắt đầu và đáp ứng
- bắt đầu nhanh
V1/V2/V2, loại thử thách và hai chế độ phiên.
- Thông số yêu cầu
Đường dẫn đích, tiêu đề yêu cầu, dấu vân tay, thời gian chờ và tùy chọn cấu hình.
- dữ liệu phản hồi
x-cb-status, lỗi JSON và bảng mã lỗi chính thức.
- Kiểm tra số dư tài khoản
POST + JSON Điểm truy vấn hoặc lưu lượng proxy.
SDK và truy cập AI
- Python SDK
Session/SessionV2, cuộc gọi không đồng bộ và truy vấn số dư.
- Node.js SDK
cb_version, xác định lỗi và mức độ ưu tiên của biến môi trường.
- Đi SDK
Các chức năng Máy khách, Phần/Cookie và proxy.
- Hướng dẫn Vibe Coding
Môi trường thời gian chạy, phân tầng lỗi, số lần thử lại có giới hạn và ranh giới nhiệm vụ AI.
Công cụ và bộ sưu tập
- API sang công cụ proxy cục bộ
Kiểm tra địa chỉ nghe, khóa mặc định và x-cb-proxy.
- Cấu hình chuyển tiếp Nginx
Máy chủ giữ chìa khóa và kiểm tra Máy chủ, SNI và phạm vi truy cập.
- Cấu hình bộ sưu tập
Tái sử dụng các công cụ proxy cục bộ; không sao chép x-cb-host trong ảnh chụp màn hình.
Ranh giới thanh toán, dùng thử và khả năng
- Tiêu thụ điểm
Yêu cầu thành công và thử thách thành công sẽ được tính phí riêng.
- Nhận bản dùng thử
Sau khi đăng ký, liên hệ với dịch vụ khách hàng theo tài liệu.
- Trình duyệt vân tay và đường viền tự động
Tài liệu rõ ràng không hỗ trợ sử dụng trực tiếp trong trình duyệt vân tay, Selenium và Puppeteer.
- Ranh giới WebSocket
Tài liệu hiện tại rõ ràng không hỗ trợ ws/wss.
Điểm, số dư và sự khác biệt về cấu hình SDK
Trước tiên hãy phân biệt giữa điểm API và lưu lượng proxy
Mô tả tài liệu chính thức: Một yêu cầu thành công tiêu tốn 1 điểm và mỗi thử thách xác minh V2 thành công tiêu tốn thêm 2 điểm; xác minh nhiều giai đoạn được thanh toán riêng. Nếu phản hồi tiếp theo sau khi thử thách thành công là không chính xác, thì điểm thử thách đã bị trừ sẽ không được trả lại, nhưng điểm yêu cầu sẽ không bị trừ nếu phản hồi không thành công. SDK Việc tự động theo dõi các phản hồi chuyển hướng cũng tiêu tốn điểm.
Giao diện cân bằng là POST https://console.cloudbypass.com/api/v1/balance, sử dụng trường JSON apikey、email、type。points Kiểm tra điểm và thời gian hết hạn,res / dat Truy vấn lưu lượng truy cập phòng dân cư/phòng máy tính, đơn vị là byte. Truy vấn GET cũ không được dùng nữa và không đưa thông tin xác thực vào URL.
SDK có các quy ước biến môi trường khác nhau: Cách sử dụng tài liệu Python/Go CB_APIKEY、CB_PROXY;Node.js ưu tiên đọc CLOUDBYPASS_APIKEY、CLOUDBYPASS_PROXY, đọc lại khi trống CB_*. Các biến trong hướng dẫn AI không tự động xuất hiện trong mọi môi trường SDK hoặc MCP từ xa.
Cả công cụ tác nhân cục bộ và Nginx đều là các phương thức truy cập chuyển tiếp; khóa được lưu trữ trong môi trường hoạt động đáng tin cậy và cần phải kiểm soát phạm vi giám sát cũng như quyền truy cập. Tài liệu rõ ràng không hỗ trợ sử dụng trực tiếp trong trình duyệt dấu vân tay, Selenium / Puppeteer, cũng như không hỗ trợ ws / wss cho WebSocket và không nhầm lẫn phản hồi phát trực tuyến HTTP với các khả năng này.
Các câu hỏi thường gặp và bằng chứng phản hồi
HTTP 200 có nghĩa là nhiệm vụ thành công?
Không. Trước tiên hãy kiểm tra x-cb-status, sau đó kiểm tra trạng thái HTTP mục tiêu, Loại nội dung và các trường kinh doanh. x-cb-status: ok có nghĩa là yêu cầu Scrapingbypass API được xử lý thành công, nhưng điều đó không có nghĩa là phải hoàn tất đăng nhập, đặt hàng hoặc lưu tệp và các dịch vụ khác.
Khi không nhận được phản hồi, cần kiểm tra mã lỗi nào?
Khi không có phản hồi HTTP, mã lỗi máy chủ Scrapingbypass API không thể được tạo. Trước tiên hãy kiểm tra các phần phụ thuộc cục bộ, môi trường hoạt động, DNS, mạng, chứng chỉ và thời gian chờ của máy khách; sau khi nhận được phản hồi, hãy đọc id, mã và tin nhắn thực tế.
Có phải tất cả 403 đều cần phải chuyển sang V2 không?
Số 403 cũng có thể đến từ việc không có quyền đối với tài khoản, giới hạn khu vực hoặc quy tắc kinh doanh mục tiêu. Khi V1 nhắc CLOUDFLARE_PREMIUM rõ ràng hoặc trả về thông tin yêu cầu V2, hãy định cấu hình V2 và tác nhân ổn định; các lỗi cấp phép thông thường sẽ không tự động biến mất do các phiên bản nâng cấp.
DataDome Tôi có cần thêm tiêu đề yêu cầu đặc biệt không?
Tài liệu Bắt đầu nhanh nêu rõ rằng thử thách DataDome được V2 tự động nhận dạng mà không cần thêm tiêu đề chuyên dụng DataDome. x-cb-proxy cố định hoặc cố định vẫn phải được định cấu hình và sử dụng các phiên cookie hoặc phần phù hợp; khả năng tương thích mục tiêu yêu cầu xác minh thực tế.
Tại sao Turnstile không được hoàn thành sau khi điền mã khóa trang web?
x-cb-sitekey cũng cần phải khớp với [cf_token] hoặc phần giữ chỗ được mã hóa URL của nó trong URL, tiêu đề yêu cầu hoặc nội dung yêu cầu. Scrapingbypass API thay thế phần giữ chỗ và chuyển tiếp yêu cầu đích, thay vì đưa Mã thông báo trần trụi trực tiếp cho khách hàng dưới dạng giá trị trả về chung.
Tại sao yêu cầu thất bại vẫn tiêu tốn điểm?
Tài liệu phân biệt giữa điểm yêu cầu và điểm thử thách: một yêu cầu thành công tiêu tốn 1 điểm và V2 tiêu tốn thêm 2 điểm cho mỗi thử thách xác minh thành công. Nếu phản hồi tiếp theo không chính xác sau khi thử thách thành công thì điểm thử thách bị trừ sẽ không được trả lại, nhưng điểm yêu cầu sẽ không bị trừ nếu phản hồi thất bại; xác minh nhiều giai đoạn được tính theo giai đoạn.
V2 có bằng giao diện tác vụ không đồng bộ nền không?
Không. V2 đang phát trực tuyến phản hồi HTTP và không tự động cung cấp các tác vụ nền, dịch vụ bỏ phiếu hoặc gọi lại chính thức. Cuộc gọi không đồng bộ từ máy khách không có nghĩa là tạo tác vụ trên máy chủ và các lượt tải xuống vẫn cần xác minh nội dung thực tế và tính toàn vẹn.
Tôi có cần gửi Khóa API khi báo cáo sự cố không?
Không cần. Chỉ cần cung cấp thời gian và múi giờ, ID yêu cầu, mục tiêu giải mẫn cảm, phiên bản, mã/thông báo, vùng và loại proxy cũng như bản ghi nỗ lực. Không gửi Khóa API, mật khẩu proxy, cookie đăng nhập, nội dung yêu cầu đầy đủ hoặc tham số truy vấn bằng Mã thông báo.

Giữ thông tin này khi liên hệ với bộ phận hỗ trợ
- Thời gian xảy ra và múi giờ, ID yêu cầu
- Mục tiêu giải mẫn cảm, phiên bản API, trạng thái HTTP
- x-cb-status, mã gốc và tin nhắn được giải mẫn cảm
- Loại proxy, khu vực, thời hạn hiệu lực và chế độ phiên
- Các bước đã thử và kết quả cuối cùng
Không đi kèm với khóa, mật khẩu proxy, cookie đăng nhập hoặc các tham số truy vấn nhạy cảm. Nếu không có ID yêu cầu, hãy chỉ định nó một cách trung thực và không tạo ra giá trị thay thế.
