Ana içeriğe geç
Windscribe

AjanlarıniçinAjanlarıniçin VPN API'si.

Yapay zeka ajanlarına kendi WireGuard VPN'lerini ver. Tek bir API çağrısıyla USDC ile satın alırlar, DNS filtrelemeyle kötü amaçlı alan adlarını engellerler ve hiçbir zaman hesaba ihtiyaç duymazlar.

Ajanlar: llms.txt adresinden başlayın. Temel URL https://api.windscribe.com/vpn

Kullanım alanları

Ajanlar kendi VPN'leriyle ne yapar

Ajanlar açık internette senin adına hareket eder. Gizli ve kontrol edilebilir bir bağlantının önemli olduğu işler şunlar.

  • Gizlilik

    Gizli gezin

    Siteler evinin veya ofisinin ağını değil, bir Windscribe IP'sini görür.

  • Coğrafi test

    Başka bir ülkeden bak

    Yerel fiyatları ve arama sonuçlarını oradaki insanların gördüğü gibi kontrol et.

  • Güvenlik

    Her ağı güvenceye al

    Otel Wi-Fi'ı, robotlar ve uç cihazlar şifreli bir WireGuard tüneli kazanır.

  • Platformlar

    Her müşteriye bir tünel

    Her çalışma alanı veya iş için bir anahtar ve bir dönem. Yönetilecek hesap yok.

ROBERT ile DNS filtreleme

Ajanının nelere erişebileceğini sınırla

Bir ajanın yönlendirilememesi için kötü amaçlı yazılım ve kimlik avı alan adlarını engelle ya da gürültüyü ve veri kullanımını azaltmak için reklamları ve izleyicileri kes. Tek bir API isteği bir anahtarın listelerini değiştirir ve tünelin DNS çözümleyicisi bunları uygular.

Filtre listeleri
DNS sorguları9 sorgudan 3 engellendi
  1. search.engine.example
  2. shocking.headlines.example
  3. miner.hashpool.example
  4. sync.tracker.exampleReklamlar + İzleyicilerENGELLENDİ
  5. shop.retailer.example
  6. odds.casino.example
  7. c2.botnet.exampleKötü amaçlı yazılımENGELLENDİ
  8. ads.network.exampleReklamlar + İzleyicilerENGELLENDİ
  9. cdn.images.example

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

Otonom ajanlar için koruma bariyerleri

Kötü bir bağlantıyı veya enjekte edilmiş bir talimatı izleyen bir ajan bile bilinen kötü amaçlı yazılım, kimlik avı veya botnet alan adlarını çözümleyemez.

Daha az veri, daha az gürültü

Reklam ve izleyici engelleme sayfaları hafifletir, böylece ajanlar gereksiz içeriğe daha az token ve bant genişliği harcar.

API ile anahtar bazında ayarla

Yeni anahtarlarda kötü amaçlı yazılım engelleme baştan açıktır. Listeleri istediğin zaman şununla değiştir:

PUT /vpn/wireguard/settings

Gizlilik ve kontrol

Kaydolacak bir şey yok, sızacak bir şey yok

Kimlik

Sıfır hesap

API kim olduğunu asla sormaz. Ajanın bir WireGuard anahtar çifti oluşturur ve açık anahtar kimliğin tamamıdır. Özel anahtar makineden hiç çıkmaz ve bağlantıyı yöneten her istek onunla imzalanır; bu yüzden onu bağlantının kendisi kadar gizli tut.

e-postaşifrekartoturumwg_pubkey ✓
x402 ödemeleri

Ajanın ödemeyi kendisi yapar

Base üzerinde USDC, açık x402 standardı aracılığıyla istek başına mutabakat. Ödeme sayfası yok, kayıtlı kart yok ve bir ödemeyi yeniden denemek asla iki kez ücret almaz.

Standart WireGuard

Her WireGuard istemcisiyle çalışır

Anahtarınla imzalanmış bir istek adresi, DNS çözümleyicisini ve önceden paylaşılan anahtarı döndürür; böylece bir wg-quick yapılandırması oluşturmak için tek bir şablon yeterlidir.

API ile tam kontrol

Erişimi yenile, taşı veya sonlandır

Daha fazla süre satın al, erişimi yeni bir anahtara taşı veya hemen iptal et; her biri tek bir imzalı istekle.

Bir ajan x402 ile nasıl VPN satın alır

Dört adımda sıfırdan tünele

Düz HTTP ve açık x402 ödeme standardı. Herhangi bir x402 v2 istemcisi özel kod olmadan ödeme yapabilir.

  1. 402

    Bir dönem iste

    Bir WireGuard açık anahtarı ve ay sayısı gönder. Yanıt tam fiyatı, ağı ve alıcıyı içerir.

    POST /vpn/wireguard

  2. x402

    Teklifi öde

    Bir USDC transfer yetkilendirmesi imzala ve aynı isteği onunla birlikte yeniden gönder.

    PAYMENT-SIGNATURE: …

  3. 201

    Yapılandırmayı oluştur

    İmzalı bir istek adresi, DNS çözümleyicisini ve önceden paylaşılan anahtarı döndürür. Konum listesinden bir çıkış seç.

    GET /vpn/wireguard/locations

  4. WG

    Bağlan

    Tüneli herhangi bir WireGuard istemcisiyle aç ve görevin gerektirdiği filtreleri ayarla.

    wg-quick up ./windscribe.conf

Fiyatlandırma

Tek fiyat, USDC ile ödenir

x402 ile Base üzerinde USDC olarak ödenir. Abonelik ve otomatik yenileme yok: süre eklemek için aynı anahtarla yeniden satın al, en fazla 12 ay ileriye kadar. Ödemeler iade edilmez.

Aylık$0
Yıllık$39 tasarruf$0

Geliştiriciler ve ajanlar için dokümanlar

Bir ajanın başlamak için ihtiyaç duyduğu her şey

OpenAPI şartnamesi her uç noktayı açıklar. llms.txt ise ajanlar için kısa sürümdür.

Bunu ajanına ver
https://windscribe.com/vpn-api/llms.txt adresini oku.
Bu makinede bir WireGuard anahtar çifti oluştur, bunun için x402 ile bir aylık Windscribe VPN erişimi satın al, kötü amaçlı yazılım ve reklam engellemeyi aç, ardından en yakın konum için bir wg-quick yapılandırması yaz. Özel anahtarı bu makinede tut.
Bir bakışta
Temel URL
https://api.windscribe.com/vpn
Keşif
GET /vpn
Ödeme
x402 v2, exact şeması, Base üzerinde USDC
Kimlik doğrulama
WireGuard anahtarıyla imzalanan istekler (wg-xeddsa-v1)
API'yi keşfet9 uç nokta, istek ve yanıt alanları, cURL, Python ve JavaScript ile kodAç
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.

İmza isteğe bağlıx402 · Base üzerinde USDCbuyWireGuardTime

Başlıklar

Başlık
Zorunlu
Açıklama
PAYMENT-SIGNATURE
hayır
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
hayır
Part of the optional purchase signature.
Content-Digest
hayır
Part of the optional purchase signature.
Signature-Input
hayır
Part of the optional purchase signature.
Signature
hayır
Part of the optional purchase signature.

İstek gövdesi · application/json

Alan
Tür
Açıklama
wg_pubkeyzorunlu
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.
monthszorunlu
integer
123456712

Yanıtlar

Payment settled and time bought

Alan
Tür
Açıklama
pubkeyzorunlu
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.
statuszorunlu
string
activeexpiredrevoked
expireszorunlu
integer
Unix seconds; access ends exactly then.
ipv4zorunlu
string
ipv6zorunlu
string
robertzorunlu
string[]
malwareadssocialporngamblingfakenewscompetitorscryptominers
wireguardzorunlu
object
[Interface] values; the [Peer] comes from a locations group and node.
wireguard.addresszorunlu
string
Interface IPv4 address with prefix, derived from the public key.
wireguard.address_v6zorunlu
string
Interface IPv6 address with prefix, derived from the public key.
wireguard.dnszorunlu
string
Windscribe resolver for the current ROBERT filters.
wireguard.allowed_ipszorunlu
"0.0.0.0/0, ::/0"
wireguard.endpoint_portzorunlu
443
purchasable_termszorunlu
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.
successzorunlu
1
payment_idzorunlu
string | null
Null when rotate moved an active entitlement.
settlement_referencezorunlu
string | null
Base transaction hash of the settlement.

Gösterilen alanlar data içinde yer alır.

İstek
# 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}'
Örnek yanıt · 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"
  }
}
All Your Devices
Stars

Ajanlarına kendi VPN'lerini ver.

POST /vpn/wireguard ile teklif al, x402 ile öde, WireGuard ile bağlan.

All Your Devices

Sorular

Satın almadan önce

Windscribe VPN API nedir?

Windscribe WireGuard VPN erişimini doğrudan bir WireGuard açık anahtarına satan bir HTTP API. Yapay zeka ajanları, betikler ve cihazlar bir Windscribe hesabı olmadan bağlantı satın alabilir, kullanabilir ve yönetebilir.

Bir yapay zeka ajanı kendi başına VPN satın alabilir mi?

Evet. Ajan WireGuard açık anahtarını ve bir dönemi gönderir, HTTP 402 ile bir fiyat teklifi alır, bunu x402 ile USDC olarak öder ve bir WireGuard yapılandırması için gereken değerleri geri alır. Hiç kimsenin kaydolması veya bir şeyi onaylaması gerekmez.

Windscribe hesabına ihtiyacım var mı?

Hayır. API asla e-posta, şifre veya oturum istemez. WireGuard açık anahtarın satın alımı tanımlar ve onu yöneten istekler eşleşen özel anahtarla imzalanır.

Nasıl ödeme yaparım?

Base üzerinde USDC ile, x402 v2 aracılığıyla. İlk istek tam tutarı ve alıcı adresini döndürür; istemcin bir USDC transfer yetkilendirmesi imzalar ve isteği yeniden gönderir.

Bu bir abonelik mi?

Hayır. Her ödeme 1 ila 7 ya da 12 aylık sabit bir dönem satın alır. Süre eklemek için aynı anahtarla yeniden satın al, en fazla 12 ay ileriye kadar.

Para iadesi alabilir miyim?

Hayır. Ödemeler iade edilmez. Bir anahtarı iptal etmek erişimi hemen sonlandırır ve kalan süre yanar; yeniden süre satın almak anahtarı tekrar etkinleştirir.

Ajanımın hangi alan adlarına erişebileceğini kontrol edebilir miyim?

Evet. Her anahtarın ROBERT DNS filtre listeleri vardır: Kötü amaçlı yazılım (kimlik avı ve botnet sunucuları dahil), Reklamlar + İzleyiciler, Sosyal Ağlar, Porno, Kumar, Tık tuzağı, Kripto ve Diğer VPN'ler. Yeni anahtarlarda Kötü amaçlı yazılım açık başlar ve PUT /vpn/wireguard/settings listeleri istediğin zaman değiştirir. Özel alan adı kuralları desteklenmez.

Hangi VPN protokolünü kullanıyor?

WireGuard. API arayüz adresini, DNS çözümleyicisini, önceden paylaşılan anahtarı ve uç nokta portunu döndürür; böylece wg-quick dahil her WireGuard istemcisi bağlanabilir.

Windscribe neleri saklar?

Açık anahtarı, oluşturulan önceden paylaşılan anahtarı, bitiş tarihini, ROBERT filtrelerini ve her ödeme için ürün ayrıntılarını, durumunu ve mutabakat işlem hash'ini. Windscribe cüzdan adresini saklamaz, ancak mutabakat Base üzerinde herkese açıktır ve ödeme yapan cüzdanı gösterir.

WireGuard anahtarım zaten kullanılıyorsa ne olur?

Bir Windscribe hesabına veya iş ortağına ait bir anahtar, herhangi bir para hareketinden önce wireguard_key_exists ile reddedilir. Yeni bir anahtar oluştur ve tekrar dene.

Hangi sunucuları kullanabilirim?

Erişimin etkin olduğu sürece GET /vpn/wireguard/locations tarafından döndürülen premium WireGuard konumları. Statik IP sunucuları dahil değildir.