穿雲API：Cloudflare 與 DataDome 驗證處理

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23#!/usr/bin/env bash
set -euo pipefail
: "${CLOUDBYPASS_APIKEY:?Set CLOUDBYPASS_APIKEY first}"
: "${CLOUDBYPASS_PROXY:?Set CLOUDBYPASS_PROXY first}"
headers=$(mktemp)
body=$(mktemp)
trap 'rm -f "$headers" "$body"' EXIT

curl --fail-with-body --silent --show-error --max-time 130 \
  --dump-header "$headers" --output "$body" \
  "https://api.cloudbypass.com/your/path" \
  --header "x-cb-apikey: $CLOUDBYPASS_APIKEY" \
  --header "x-cb-host: example.com" \
  --header "x-cb-version: 2" \
  --header "x-cb-proxy: $CLOUDBYPASS_PROXY" \
  --header "x-cb-part: 0" \
  --header "x-cb-timeout: 120"

if ! grep -iq '^x-cb-status: *ok[[:space:]]*$' "$headers"; then
  cat "$body" >&2
  exit 1
fi
cat "$body"

API Key

CLOUDBYPASS_APIKEY

固定或黏性代理

CLOUDBYPASS_PROXY

目標網站

example.com

執行環境

Bash + cURL 7.76+

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26import os
import requests

key = os.environ["CLOUDBYPASS_APIKEY"]
proxy = os.environ["CLOUDBYPASS_PROXY"]
if not key or not proxy:
    raise ValueError("Set API key and proxy first")

headers = {
    "x-cb-apikey": key,
    "x-cb-host": "example.com",
    "x-cb-version": "2",
    "x-cb-proxy": proxy,
    "x-cb-part": "0",
    "x-cb-timeout": "120",
}

response = requests.get(
    "https://api.cloudbypass.com/your/path",
    headers=headers,
    timeout=(10, 130),
)
if response.headers.get("x-cb-status") != "ok":
    raise RuntimeError(response.text)
response.raise_for_status()
print(response.text)

API Key

CLOUDBYPASS_APIKEY

固定或黏性代理

CLOUDBYPASS_PROXY

目標網站

example.com

執行環境

Python 3 + requests

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35package main

import (
    "fmt"
    "io"
    "log"
    "net/http"
    "os"
    "time"
)

func main() {
    key, proxy := os.Getenv("CLOUDBYPASS_APIKEY"), os.Getenv("CLOUDBYPASS_PROXY")
    if key == "" || proxy == "" { log.Fatal("Set API key and proxy first") }
    req, err := http.NewRequest("GET",
        "https://api.cloudbypass.com/your/path", nil)
    if err != nil { log.Fatal(err) }
    req.Header.Set("x-cb-apikey", key)
    req.Header.Set("x-cb-host", "example.com")
    req.Header.Set("x-cb-version", "2")
    req.Header.Set("x-cb-proxy", proxy)
    req.Header.Set("x-cb-part", "0")
    req.Header.Set("x-cb-timeout", "120")

    client := &http.Client{Timeout: 130 * time.Second}
    res, err := client.Do(req)
    if err != nil { log.Fatal(err) }
    defer res.Body.Close()
    body, err := io.ReadAll(res.Body)
    if err != nil { log.Fatal(err) }
    if res.Header.Get("x-cb-status") != "ok" || res.StatusCode >= 400 {
        log.Fatal(string(body))
    }
    fmt.Println(string(body))
}

API Key

CLOUDBYPASS_APIKEY

固定或黏性代理

CLOUDBYPASS_PROXY

目標網站

example.com

執行環境

Go 1.16+

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29async function main() {
  const key = process.env.CLOUDBYPASS_APIKEY;
  const proxy = process.env.CLOUDBYPASS_PROXY;
  if (!key || !proxy) throw new Error("Set API key and proxy first");

  const response = await fetch(
    "https://api.cloudbypass.com/your/path",
    {
      headers: {
        "x-cb-apikey": key,
        "x-cb-host": "example.com",
        "x-cb-version": "2",
        "x-cb-proxy": proxy,
        "x-cb-part": "0",
        "x-cb-timeout": "120",
      },
      signal: AbortSignal.timeout(130000),
    }
  );
  const body = await response.text();
  if (response.headers.get("x-cb-status") !== "ok" || !response.ok) {
    throw new Error(body);
  }
  console.log(body);
}
main().catch(error => {
  console.error(error.message);
  process.exitCode = 1;
});

API Key

CLOUDBYPASS_APIKEY

固定或黏性代理

CLOUDBYPASS_PROXY

目標網站

example.com

執行環境

Node.js 20+

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class Main {
    public static void main(String[] args) throws Exception {
        String key = System.getenv("CLOUDBYPASS_APIKEY");
        String proxy = System.getenv("CLOUDBYPASS_PROXY");
        if (key == null || key.isBlank() || proxy == null || proxy.isBlank()) {
            throw new IllegalStateException("Set API key and proxy first");
        }
        HttpClient client = HttpClient.newBuilder()
            .connectTimeout(Duration.ofSeconds(10)).build();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.cloudbypass.com/your/path"))
            .timeout(Duration.ofSeconds(130))
            .header("x-cb-apikey", key)
            .header("x-cb-host", "example.com")
            .header("x-cb-version", "2")
            .header("x-cb-proxy", proxy)
            .header("x-cb-part", "0")
            .header("x-cb-timeout", "120")
            .GET().build();
        HttpResponse<String> response = client.send(
            request, HttpResponse.BodyHandlers.ofString());
        if (!response.headers().firstValue("x-cb-status").orElse("").equals("ok")
                || response.statusCode() >= 400) {
            throw new IllegalStateException(response.body());
        }
        System.out.println(response.body());
    }
}

API Key

CLOUDBYPASS_APIKEY

固定或黏性代理

CLOUDBYPASS_PROXY

目標網站

example.com

執行環境

Java 11+