Chuyển đến nội dung chính
Windscribe

VPN APIcho cácVPN APIcho các tác tử của bạn.

Trao cho các tác tử AI của bạn một VPN WireGuard riêng. Chúng tự mua bằng USDC chỉ với một lệnh gọi API, chặn tên miền độc hại bằng lọc DNS và không bao giờ cần tài khoản.

Bắt đầuĐặc tả OpenAPI

Tác tử: hãy bắt đầu tại llms.txt. URL gốc https://api.windscribe.com/vpn

Trường hợp sử dụng

Tác tử làm gì với VPN riêng của mình

Tác tử thay bạn hoạt động trên web mở. Đây là những công việc mà một kết nối riêng tư, có thể kiểm soát thực sự quan trọng.

  • Quyền riêng tư

    Duyệt web riêng tư

    Các trang web chỉ thấy IP của Windscribe, không bao giờ thấy mạng nhà hay mạng văn phòng của bạn.

  • Kiểm thử theo vùng

    Xem từ quốc gia khác

    Kiểm tra giá và kết quả tìm kiếm địa phương đúng như người dân ở đó nhìn thấy.

  • Bảo mật

    Bảo vệ mọi mạng

    Wi-Fi khách sạn, robot và thiết bị biên đều có đường hầm WireGuard được mã hóa.

  • Nền tảng

    Mỗi khách hàng một đường hầm

    Mỗi không gian làm việc hoặc tác vụ một khóa và một kỳ hạn. Không có tài khoản nào phải quản lý.

Lọc DNS với ROBERT

Giới hạn những gì tác tử có thể truy cập

Chặn tên miền mã độc và lừa đảo để tác tử không bị dẫn tới đó, hoặc loại bỏ quảng cáo và trình theo dõi để giảm nhiễu và dung lượng dữ liệu. Chỉ một yêu cầu API là đổi được danh sách cho một khóa, và trình phân giải DNS của đường hầm sẽ thực thi chúng.

Danh sách bộ lọc
Truy vấn DNSĐã chặn 3 trên 9
  1. search.engine.example
  2. shocking.headlines.example
  3. miner.hashpool.example
  4. sync.tracker.exampleQuảng cáo + Trình theo dõiĐÃ CHẶN
  5. shop.retailer.example
  6. odds.casino.example
  7. c2.botnet.exampleMã độcĐÃ CHẶN
  8. ads.network.exampleQuảng cáo + Trình theo dõiĐÃ CHẶN
  9. cdn.images.example

PUT /vpn/wireguard/settings{"robert": ["malware","ads"]}→ wireguard.dns = 10.255.255.3

Rào chắn cho tác tử tự hành

Một tác tử lỡ theo một liên kết độc hại hay một chỉ dẫn bị chèn vào vẫn không thể phân giải các tên miền mã độc, lừa đảo hoặc botnet đã biết.

Ít dữ liệu hơn, ít nhiễu hơn

Chặn quảng cáo và trình theo dõi giúp trang nhẹ hơn, nên tác tử tốn ít token và băng thông hơn cho những thứ thừa thãi.

Thiết lập theo khóa, qua API

Khóa mới được bật sẵn chặn mã độc. Thay đổi danh sách bất cứ lúc nào bằng:

PUT /vpn/wireguard/settings

Quyền riêng tư và kiểm soát

Không cần đăng ký, không có gì để rò rỉ

Danh tính

Không tài khoản

API không bao giờ hỏi bạn là ai. Tác tử của bạn tạo một cặp khóa WireGuard, và khóa công khai chính là toàn bộ danh tính. Khóa riêng tư không bao giờ rời khỏi máy, và mọi yêu cầu quản lý kết nối đều được ký bằng nó, vì vậy hãy giữ nó kín đáo như chính kết nối của bạn.

emailmật khẩuthẻphiênwg_pubkey ✓
Thanh toán x402

Tác tử của bạn tự thanh toán

USDC trên Base, quyết toán theo từng yêu cầu qua tiêu chuẩn mở x402. Không có trang thanh toán, không lưu thẻ, và thử lại một khoản thanh toán sẽ không bao giờ bị trừ tiền hai lần.

WireGuard tiêu chuẩn

Dùng được với mọi ứng dụng WireGuard

Một yêu cầu được ký bằng khóa của bạn sẽ trả về địa chỉ, trình phân giải DNS và khóa chia sẻ trước, nên tạo cấu hình wg-quick chỉ cần một mẫu.

Toàn quyền kiểm soát qua API

Gia hạn, chuyển hoặc chấm dứt quyền truy cập

Mua thêm thời gian, chuyển quyền truy cập sang khóa mới hoặc thu hồi ngay lập tức, mỗi việc chỉ cần một yêu cầu đã ký.

Cách tác tử mua VPN với x402

Từ con số không đến đường hầm trong bốn bước

HTTP thuần và tiêu chuẩn thanh toán mở x402. Bất kỳ ứng dụng x402 v2 nào cũng có thể thanh toán mà không cần mã tùy chỉnh.

  1. 402

    Yêu cầu kỳ hạn

    Gửi khóa công khai WireGuard và số tháng. Phản hồi là giá chính xác, mạng và bên nhận tiền.

    POST /vpn/wireguard

  2. x402

    Thanh toán báo giá

    Ký một ủy quyền chuyển USDC và gửi lại chính yêu cầu đó kèm theo ủy quyền.

    PAYMENT-SIGNATURE: …

  3. 201

    Tạo cấu hình

    Một yêu cầu đã ký trả về địa chỉ, trình phân giải DNS và khóa chia sẻ trước. Chọn điểm ra từ danh sách vị trí.

    GET /vpn/wireguard/locations

  4. WG

    Kết nối

    Bật đường hầm bằng bất kỳ ứng dụng WireGuard nào và đặt các bộ lọc mà tác vụ cần.

    wg-quick up ./windscribe.conf

Bảng giá

Một mức giá, thanh toán bằng USDC

Thanh toán bằng USDC trên Base qua x402. Không có gói đăng ký và không tự động gia hạn: mua lại với cùng khóa để cộng thêm thời gian, tối đa 12 tháng trước. Các khoản thanh toán là không hoàn lại.

Hàng tháng$0
Hàng nămTiết kiệm $39$0

Tài liệu cho nhà phát triển và tác tử

Mọi thứ tác tử cần để bắt đầu

Đặc tả OpenAPI mô tả mọi endpoint. llms.txt là bản rút gọn dành cho tác tử.

YAMLopenapi.yamlĐặc tả OpenAPI 3.1 cho mọi endpointTXTllms.txtTóm tắt cho tác tử: luồng, cấu hình, lỗiPYsign_request.pyCông cụ ký yêu cầu tham chiếu
Giao đoạn này cho tác tử của bạn
Đọc https://windscribe.com/vpn-api/llms.txt.
Tạo một cặp khóa WireGuard trên máy này, mua một tháng truy cập Windscribe VPN cho khóa đó bằng x402, bật chặn mã độc và quảng cáo, rồi viết một cấu hình wg-quick cho vị trí gần nhất. Giữ khóa riêng tư trên máy này.
Tổng quan
URL gốc
https://api.windscribe.com/vpn
Khám phá
GET /vpn
Thanh toán
x402 v2, lược đồ exact, USDC trên Base
Xác thực
Yêu cầu được ký bằng khóa WireGuard (wg-xeddsa-v1)
Khám phá API9 endpoint, các trường yêu cầu và phản hồi, mã bằng cURL, Python và JavaScriptMở
POST/vpn/wireguard

Buy time for a WireGuard key

Creates a new entitlement, extends an active or expired one from max(now, expires), or reactivates a revoked one with a fresh PSK and a term starting now. Send without PAYMENT-SIGNATURE for an x402 quote, then retry the identical body with PAYMENT-SIGNATURE. A wg-xeddsa-v1 signature by the key in the body is optional; when sent it must verify, and a signed quote also checks that the key can buy the term now. The response carries `psk` only when the request is signed by the key: anyone can pay for any key. Retrying the same PAYMENT-SIGNATURE never pays twice.

Chữ ký tùy chọnx402 · USDC trên BasebuyWireGuardTime

Header

Tên header
Bắt buộc
Mô tả
PAYMENT-SIGNATURE
không
Base64 x402 v2 PaymentPayload. Omit to receive a quote. Its authorization's validBefore must be at most maxTimeoutSeconds, plus 30 seconds of clock skew, from now.
X-Windscribe-WireGuard-Key
không
Part of the optional purchase signature.
Content-Digest
không
Part of the optional purchase signature.
Signature-Input
không
Part of the optional purchase signature.
Signature
không
Part of the optional purchase signature.

Nội dung yêu cầu · application/json

Trường
Kiểu
Mô tả
wg_pubkeybắt buộc
string
A WireGuard X25519 public key as `wg pubkey` prints it: canonical base64 of 32 bytes, u below 2^255 - 19 (top bit clear), and not a small-order point.
monthsbắt buộc
integer
123456712

Phản hồi

Payment settled and time bought

Trường
Kiểu
Mô tả
pubkeybắt buộc
string
A WireGuard X25519 public key as `wg pubkey` prints it: canonical base64 of 32 bytes, u below 2^255 - 19 (top bit clear), and not a small-order point.
statusbắt buộc
string
activeexpiredrevoked
expiresbắt buộc
integer
Unix seconds; access ends exactly then.
ipv4bắt buộc
string
ipv6bắt buộc
string
robertbắt buộc
string[]
malwareadssocialporngamblingfakenewscompetitorscryptominers
wireguardbắt buộc
object
[Interface] values; the [Peer] comes from a locations group and node.
wireguard.addressbắt buộc
string
Interface IPv4 address with prefix, derived from the public key.
wireguard.address_v6bắt buộc
string
Interface IPv6 address with prefix, derived from the public key.
wireguard.dnsbắt buộc
string
Windscribe resolver for the current ROBERT filters.
wireguard.allowed_ipsbắt buộc
"0.0.0.0/0, ::/0"
wireguard.endpoint_portbắt buộc
443
purchasable_termsbắt buộc
integer[]
Terms that a purchase would accept now without exceeding the 12-month cap.
123456712
psk
string
WireGuard preshared key for the [Peer] section. Only when the request is signed by the key; otherwise read it with a signed GET /vpn/wireguard.
successbắt buộc
1
payment_idbắt buộc
string | null
Null when rotate moved an active entitlement.
settlement_referencebắt buộc
string | null
Base transaction hash of the settlement.

Các trường hiển thị nằm bên trong data.

Yêu cầu
# 1. Quote. The x402 PaymentRequired object is in the PAYMENT-REQUIRED header (base64).
curl -si https://api.windscribe.com/vpn/wireguard \
  -H 'Content-Type: application/json' \
  -d '{"wg_pubkey":"<your WireGuard public key>","months":1}'

# 2. Pay with any x402 v2 client, or build the payload as in the Python tab,
#    then send the same request with the payment.
curl -s https://api.windscribe.com/vpn/wireguard \
  -H 'Content-Type: application/json' \
  -H "PAYMENT-SIGNATURE: $PAYMENT" \
  -d '{"wg_pubkey":"<your WireGuard public key>","months":1}'
Phản hồi mẫu · 201
{
  "data": {
    "pubkey": "j0DFrbaPJWJK5bIU6nZ6bslNgp09e14a0bpvPiE4KF8=",
    "status": "active",
    "expires": 1797207705,
    "ipv4": "100.88.12.34",
    "ipv6": "fd54:4::5c0c:2a2",
    "robert": [
      "malware"
    ],
    "wireguard": {
      "address": "100.88.12.34/32",
      "address_v6": "fd54:4::5c0c:2a2/128",
      "dns": "10.255.255.2",
      "allowed_ips": "0.0.0.0/0, ::/0",
      "endpoint_port": 443
    },
    "purchasable_terms": [
      1,
      2,
      3,
      4,
      5,
      6,
      7
    ],
    "psk": "EXAMPLEexampleEXAMPLEexampleEXAMPLEexample0=",
    "success": 1,
    "payment_id": "6c1f0e9a2b7d4c3e8f5a1b0c9d8e7f6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e",
    "settlement_reference": "0xeb0c71793e4e18a80c8123e34c8f908404f4ee107d3c8dfea4c742ad73e01ccf"
  }
}

Cho tác tử của bạn một VPN riêng.

Báo giá với POST /vpn/wireguard, thanh toán bằng x402, kết nối bằng WireGuard.

Bắt đầuĐọc llms.txt

Câu hỏi

Trước khi bạn mua

Windscribe VPN API là gì?

Một API HTTP bán quyền truy cập Windscribe WireGuard VPN trực tiếp cho một khóa công khai WireGuard. Tác tử AI, script và thiết bị có thể mua, sử dụng và quản lý kết nối mà không cần tài khoản Windscribe.

Tác tử AI có thể tự mua VPN không?

Có. Tác tử gửi khóa công khai WireGuard và kỳ hạn, nhận báo giá HTTP 402, thanh toán bằng USDC qua x402 và nhận lại các giá trị cho cấu hình WireGuard. Không ai phải đăng ký hay xác nhận gì cả.

Tôi có cần tài khoản Windscribe không?

Không. API không bao giờ yêu cầu email, mật khẩu hay phiên. Khóa công khai WireGuard của bạn định danh giao dịch mua, và các yêu cầu quản lý nó được ký bằng khóa riêng tư tương ứng.

Tôi thanh toán bằng cách nào?

Bằng USDC trên Base, qua x402 v2. Yêu cầu đầu tiên trả về số tiền chính xác và địa chỉ nhận; ứng dụng khách của bạn ký một ủy quyền chuyển USDC rồi gửi lại yêu cầu.

Đây có phải gói đăng ký không?

Không. Mỗi lần thanh toán mua một kỳ hạn cố định từ 1 đến 7 hoặc 12 tháng. Mua lại với cùng khóa để cộng thêm thời gian, tối đa 12 tháng trước.

Tôi có được hoàn tiền không?

Không. Các khoản thanh toán là không hoàn lại. Thu hồi khóa sẽ chấm dứt quyền truy cập ngay lập tức và mất phần thời gian còn lại; mua thời gian lần nữa sẽ kích hoạt lại khóa.

Tôi có thể kiểm soát tên miền nào tác tử được truy cập không?

Có. Mỗi khóa có các danh sách bộ lọc DNS của ROBERT: Mã độc (bao gồm máy chủ lừa đảo và botnet), Quảng cáo + Trình theo dõi, Mạng xã hội, Khiêu dâm, Cờ bạc, Giật tít, Tiền mã hóa và VPN khác. Khóa mới được bật sẵn Mã độc, và PUT /vpn/wireguard/settings đổi danh sách bất cứ lúc nào. Không hỗ trợ quy tắc tên miền tùy chỉnh.

Dịch vụ dùng giao thức VPN nào?

WireGuard. API trả về địa chỉ giao diện, trình phân giải DNS, khóa chia sẻ trước và cổng endpoint, nên mọi ứng dụng WireGuard, kể cả wg-quick, đều kết nối được.

Windscribe lưu trữ những gì?

Khóa công khai, khóa chia sẻ trước được tạo, thời hạn, các bộ lọc ROBERT của bạn, và với mỗi khoản thanh toán là chi tiết sản phẩm, trạng thái và mã băm giao dịch quyết toán. Windscribe không lưu địa chỉ ví của bạn, nhưng giao dịch quyết toán là công khai trên Base và cho thấy ví đã thanh toán.

Nếu khóa WireGuard của tôi đã được dùng thì sao?

Khóa thuộc về tài khoản Windscribe hoặc đối tác sẽ bị từ chối với wireguard_key_exists trước khi có bất kỳ khoản tiền nào được chuyển. Hãy tạo khóa mới và thử lại.

Tôi có thể dùng những máy chủ nào?

Các vị trí WireGuard cao cấp do GET /vpn/wireguard/locations trả về trong thời gian quyền truy cập của bạn còn hiệu lực. Không bao gồm máy chủ IP tĩnh.