穿雲API常見問題

Cloudflare 與 DataDome 共用同一套 API 點數，採用統一的點數消耗規則與定價策略。依業務用量選擇方案；代理流量分開計費。

V1、V2 每次請求成功後消耗 1 點 API 點數。

V2 遇到並成功完成驗證挑戰時，額外消耗 2 點。適用挑戰包括 Cloudflare JS 質詢、Cloudflare Turnstile、DataDome 與 Incapsula。

請求未成功時不扣基本請求點數；但驗證挑戰成功後會立即扣除 2 點，即使後續回應出錯，這部分挑戰點數也不會退還。

重複使用有效工作階段可減少重複挑戰，但每次成功請求仍消耗 1 點，並非工作階段內的後續請求免費。

點數須在方案有效期內使用，逾期後清空。不同方案分別計算有效期，並優先使用最早到期的點數。

透過標準 HTTP 請求，以同一套接入邏輯與程式碼呼叫方式處理 Cloudflare 與 DataDome，保留現有資料擷取框架。保持代理 IP、Cookie 與工作階段一致，並檢查回應狀態與內容。 是否支援特定目標仍取決於網站與驗證類型，請先測試相容性。統一方案不代表所有目標都能成功存取。

Cloudflare 與 DataDome 共用相同的 API 接入邏輯與程式碼呼叫方式。

穿雲API本身很簡單，您只需要將發送到目標網站的http請求體發給我們，我們會將請求轉送至 x-cb-host 指定的目標。
可以使用程式碼產生器，線上產生程式碼片段，用於cURL、JavaScript 、TypeScript、Java、Python等指令發出HTTP請求。
穿雲API和穿雲代理IP 程式碼範例：點擊查看

V2版本能過js輪詢(能渲染JS)；
目前V2版本沒有預設代理，需要再購買穿雲代理IP，V1版本自帶動態代理

會話分區用來區分管理cloudflare Cookie的，透過驗證後會話生效。生效後代理IP、指紋等將持續10分鐘無法更改，這是為了確保在會話期間內不會觸發新的驗證。至於帳號會話需要自行管理。
從0-999，使用者最多可以擁有1000個會話分區。第一次請求成功後會話分區將會鎖定代理IP，可以透過修改會話分區值提交其它代理IP。會話鎖定時長為十分鐘，成功請求將刷新時長。

將請求位址輸入 程式碼產生器 內測試，先用穿雲V1測試 ；
如果V1過不去，就可以用穿雲V2版本測試，V2需要自己配置IP，我們後台贈送了測試的IP代理流量，點擊 穿雲代理IP後台 去提取下，提取IP建議設定10分鐘以上的時效。

目前我們所有套餐的最大並發請求數是30次/s。

INSUFFICIENT_BALANCE 這個錯誤是你沒有穿雲API積分了。

你可以在穿雲API後台購買：https://console.cloudbypass.com/#/api/login，或 聯絡客服：領取測試積分。

報錯訊息：
"code": "CHALLENGE_LOCK_OCCUPIED"
"message": "The current part is being challenged, please wait for the lock to be released."

錯誤說明：
出現 CHALLENGE_LOCK_OCCUPIED 說明程式碼可能有以下問題：
同一 part 被多個線程同時使用。
多個使用者使用同一帳號並操作相同 part。
上一個請求佔用了驗證鎖，可能因逾時或人為中斷而尚未完成。

解決方案：
等待鎖定釋放，稍後再嘗試請求。
更換 part，可選範圍為 0~999。

解決方案：
1.提取IP時設定10分鐘時效。
2、換個國家地區的IP。 （多提取點不同國家的IP輪詢使用，只用同一個國家地區的IP容易被限制）

這種情況大機率是需要設定代理IP了，選擇API模式和代理模式其中一種來使用我們的服務，國內用戶推薦使用API模式，目前只支援http協定的代理IP。

目前不支援selenium或Puppeteer，因為沒使用到瀏覽器，只是模擬瀏覽器請求，但你可以結合指紋瀏覽器使用。