Vai al contenuto principale
Windscribe

L'API VPNper i tuoiL'API VPNper i tuoi agenti.

Dai ai tuoi agenti IA la loro VPN WireGuard. La acquistano in USDC con una sola chiamata API, bloccano i domini malevoli con il filtro DNS e non hanno mai bisogno di un account.

Agenti: iniziate da llms.txt. URL di base https://api.windscribe.com/vpn

Casi d'uso

Cosa fanno gli agenti con la propria VPN

Gli agenti agiscono sul web aperto per conto tuo. Queste sono le attività in cui conta una connessione privata e controllabile.

  • Privacy

    Naviga in privato

    I siti vedono un IP di Windscribe, mai la rete di casa o dell'ufficio.

  • Test geografici

    Guarda un altro paese

    Controlla i prezzi locali e i risultati di ricerca così come li vedono le persone del posto.

  • Sicurezza

    Proteggi qualsiasi rete

    Wi-Fi degli hotel, robot e dispositivi edge ottengono un tunnel WireGuard cifrato.

  • Piattaforme

    Un tunnel per cliente

    Una chiave e un periodo per workspace o attività. Nessun account da gestire.

Filtro DNS con ROBERT

Limita ciò che il tuo agente può raggiungere

Blocca i domini di malware e phishing così nessuno può indirizzarci un agente, oppure elimina pubblicità e tracker per ridurre il rumore e il consumo di dati. Una sola richiesta API cambia gli elenchi di una chiave, e il resolver DNS del tunnel li applica.

Elenchi di filtri
Query DNS3 su 9 bloccate
  1. search.engine.example
  2. shocking.headlines.example
  3. miner.hashpool.example
  4. sync.tracker.examplePubblicità + trackerBLOCCATO
  5. shop.retailer.example
  6. odds.casino.example
  7. c2.botnet.exampleMalwareBLOCCATO
  8. ads.network.examplePubblicità + trackerBLOCCATO
  9. cdn.images.example

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

Protezioni per agenti autonomi

Un agente che segue un link malevolo o un'istruzione iniettata non riesce comunque a risolvere domini noti di malware, phishing o botnet.

Meno dati, meno rumore

Bloccare pubblicità e tracker alleggerisce le pagine, così gli agenti spendono meno token e meno banda per il superfluo.

Impostato per chiave, tramite API

Le nuove chiavi partono con il blocco dei malware attivo. Cambia gli elenchi in qualsiasi momento con:

PUT /vpn/wireguard/settings

Privacy e controllo

Niente da registrare, niente da far trapelare

Identità

Zero account

L'API non chiede mai chi sei. Il tuo agente genera una coppia di chiavi WireGuard, e la chiave pubblica è l'intera identità. La chiave privata non lascia mai la macchina e ogni richiesta che gestisce la connessione viene firmata con essa, quindi tienila privata quanto la connessione stessa.

e-mailpasswordcartasessionewg_pubkey ✓
Pagamenti x402

Il tuo agente paga da solo

USDC su Base, regolato a ogni richiesta tramite lo standard aperto x402. Nessuna pagina di checkout, nessuna carta salvata, e ritentare un pagamento non addebita mai due volte.

WireGuard standard

Funziona con qualsiasi client WireGuard

Una richiesta firmata con la tua chiave restituisce indirizzo, resolver DNS e chiave pre-condivisa, quindi per creare una configurazione wg-quick basta un solo modello.

Controllo completo via API

Rinnova, trasferisci o termina l'accesso

Acquista altro tempo, trasferisci l'accesso a una nuova chiave o revocalo subito, ognuno con un'unica richiesta firmata.

Come un agente acquista una VPN con x402

Da zero a un tunnel in quattro passaggi

HTTP semplice e lo standard di pagamento aperto x402. Qualsiasi client x402 v2 può pagare senza codice personalizzato.

  1. 402

    Chiedi un periodo

    Invia una chiave pubblica WireGuard e un numero di mesi. La risposta contiene il prezzo esatto, la rete e il beneficiario.

    POST /vpn/wireguard

  2. x402

    Paga il preventivo

    Firma un'autorizzazione di trasferimento USDC e invia di nuovo la stessa richiesta includendola.

    PAYMENT-SIGNATURE: …

  3. 201

    Crea la configurazione

    Una richiesta firmata restituisce indirizzo, resolver DNS e chiave pre-condivisa. Scegli un'uscita dall'elenco delle località.

    GET /vpn/wireguard/locations

  4. WG

    Connettiti

    Attiva il tunnel con qualsiasi client WireGuard e imposta i filtri di cui l'attività ha bisogno.

    wg-quick up ./windscribe.conf

Prezzi

Un unico prezzo, pagato in USDC

Pagato in USDC su Base con x402. Nessun abbonamento e nessun rinnovo automatico: acquista di nuovo con la stessa chiave per aggiungere tempo, fino a 12 mesi in anticipo. I pagamenti sono definitivi.

Mensile0 $
AnnualeRisparmia 39 $0 $

Documentazione per sviluppatori e agenti

Tutto ciò che serve a un agente per iniziare

La specifica OpenAPI descrive ogni endpoint. llms.txt è la versione breve per gli agenti.

Dai questo al tuo agente
Leggi https://windscribe.com/vpn-api/llms.txt.
Crea una coppia di chiavi WireGuard su questa macchina, acquista per essa un mese di accesso alla VPN Windscribe con x402, attiva il blocco di malware e pubblicità, quindi scrivi una configurazione wg-quick per la località più vicina. Tieni la chiave privata su questa macchina.
In breve
URL di base
https://api.windscribe.com/vpn
Rilevamento
GET /vpn
Pagamento
x402 v2, schema exact, USDC su Base
Autenticazione
Richieste firmate con la chiave WireGuard (wg-xeddsa-v1)
Esplora l'API9 endpoint, campi di richiesta e risposta, codice in cURL, Python e JavaScriptApri
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.

Firma facoltativax402 · USDC su BasebuyWireGuardTime

Intestazioni

Intestazione
Obbligatorio
Descrizione
PAYMENT-SIGNATURE
no
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
no
Part of the optional purchase signature.
Content-Digest
no
Part of the optional purchase signature.
Signature-Input
no
Part of the optional purchase signature.
Signature
no
Part of the optional purchase signature.

Corpo della richiesta · application/json

Campo
Tipo
Descrizione
wg_pubkeyobbligatorio
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.
monthsobbligatorio
integer
123456712

Risposte

Payment settled and time bought

Campo
Tipo
Descrizione
pubkeyobbligatorio
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.
statusobbligatorio
string
activeexpiredrevoked
expiresobbligatorio
integer
Unix seconds; access ends exactly then.
ipv4obbligatorio
string
ipv6obbligatorio
string
robertobbligatorio
string[]
malwareadssocialporngamblingfakenewscompetitorscryptominers
wireguardobbligatorio
object
[Interface] values; the [Peer] comes from a locations group and node.
wireguard.addressobbligatorio
string
Interface IPv4 address with prefix, derived from the public key.
wireguard.address_v6obbligatorio
string
Interface IPv6 address with prefix, derived from the public key.
wireguard.dnsobbligatorio
string
Windscribe resolver for the current ROBERT filters.
wireguard.allowed_ipsobbligatorio
"0.0.0.0/0, ::/0"
wireguard.endpoint_portobbligatorio
443
purchasable_termsobbligatorio
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.
successobbligatorio
1
payment_idobbligatorio
string | null
Null when rotate moved an active entitlement.
settlement_referenceobbligatorio
string | null
Base transaction hash of the settlement.

I campi mostrati si trovano dentro data.

Richiesta
# 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}'
Risposta di esempio · 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

Dai ai tuoi agenti la loro VPN.

Chiedi il preventivo con POST /vpn/wireguard, paga con x402, connettiti con WireGuard.

All Your Devices

Domande

Prima di acquistare

Che cos'è l'API VPN di Windscribe?

Un'API HTTP che vende l'accesso alla VPN WireGuard di Windscribe direttamente a una chiave pubblica WireGuard. Agenti IA, script e dispositivi possono acquistare, usare e gestire una connessione senza un account Windscribe.

Un agente IA può acquistare una VPN da solo?

Sì. L'agente invia la sua chiave pubblica WireGuard e un periodo, riceve un preventivo HTTP 402, lo paga in USDC con x402 e ottiene i valori per una configurazione WireGuard. Nessuna persona deve registrarsi o confermare nulla.

Mi serve un account Windscribe?

No. L'API non chiede mai e-mail, password o sessione. La tua chiave pubblica WireGuard identifica l'acquisto, e le richieste che lo gestiscono vengono firmate con la chiave privata corrispondente.

Come pago?

In USDC su Base, tramite x402 v2. La prima richiesta restituisce l'importo esatto e l'indirizzo di ricezione; il tuo client firma un'autorizzazione di trasferimento USDC e invia di nuovo la richiesta.

È un abbonamento?

No. Ogni pagamento acquista un periodo fisso da 1 a 7 o 12 mesi. Acquista di nuovo con la stessa chiave per aggiungere tempo, fino a 12 mesi in anticipo.

Posso ottenere un rimborso?

No. I pagamenti sono definitivi. Revocare una chiave termina subito l'accesso e fa perdere il tempo rimanente; acquistare di nuovo tempo riattiva la chiave.

Posso controllare quali domini può raggiungere il mio agente?

Sì. Ogni chiave ha elenchi di filtri DNS di ROBERT: Malware (compresi server di phishing e botnet), Pubblicità + tracker, Social network, Porno, Gioco d'azzardo, Acchiappaclic, Cripto e Altre VPN. Le nuove chiavi partono con Malware attivo, e PUT /vpn/wireguard/settings cambia gli elenchi in qualsiasi momento. Le regole di dominio personalizzate non sono supportate.

Quale protocollo VPN usa?

WireGuard. L'API restituisce l'indirizzo dell'interfaccia, il resolver DNS, la chiave pre-condivisa e la porta dell'endpoint, quindi qualsiasi client WireGuard, compreso wg-quick, può connettersi.

Cosa memorizza Windscribe?

La chiave pubblica, una chiave pre-condivisa generata, la scadenza, i tuoi filtri ROBERT e, per ogni pagamento, i dettagli del prodotto, lo stato e l'hash della transazione di regolamento. Windscribe non memorizza l'indirizzo del tuo wallet, ma il regolamento è pubblico su Base e mostra il wallet che ha pagato.

E se la mia chiave WireGuard è già in uso?

Una chiave che appartiene a un account Windscribe o a un partner viene rifiutata con wireguard_key_exists prima che si muova denaro. Genera una nuova chiave e riprova.

Quali server posso usare?

Le località WireGuard premium restituite da GET /vpn/wireguard/locations finché il tuo accesso è attivo. I server con IP statico non sono inclusi.