L'API VPNpour vosL'API VPNpour vos agents.
Offrez à vos agents IA leur propre VPN WireGuard. Ils l'achètent en USDC en un seul appel API, bloquent les domaines malveillants grâce au filtrage DNS et n'ont jamais besoin de compte.
Agents : commencez par llms.txt. URL de base https://api.windscribe.com/vpn
Cas d'usage
Ce que les agents font avec leur propre VPN
Les agents agissent sur le Web ouvert pour vous. Voici les tâches où une connexion privée et contrôlable compte.
- Confidentialité
Naviguer en privé
Les sites voient une IP Windscribe, jamais le réseau de votre domicile ou de votre bureau.
- Tests géographiques
Voir un autre pays
Vérifiez les prix locaux et les résultats de recherche tels que les voient les gens sur place.
- Sécurité
Sécuriser n'importe quel réseau
Wi-Fi d'hôtel, robots et appareils en périphérie bénéficient d'un tunnel WireGuard chiffré.
- Plateformes
Un tunnel par client
Une clé et une durée par espace de travail ou par tâche. Aucun compte à gérer.
Filtrage DNS avec ROBERT
Limitez ce que votre agent peut atteindre
Bloquez les domaines de malwares et de phishing pour qu'un agent ne puisse pas y être redirigé, ou supprimez publicités et traqueurs pour réduire le bruit et la consommation de données. Une seule requête API change les listes d'une clé, et le résolveur DNS du tunnel les applique.
- search.engine.example
- shocking.headlines.example
- miner.hashpool.example
- sync.tracker.examplePubs + traqueursBLOQUÉ
- shop.retailer.example
- odds.casino.example
- c2.botnet.exampleMalwaresBLOQUÉ
- ads.network.examplePubs + traqueursBLOQUÉ
- cdn.images.example
PUT /vpn/wireguard/settings{"robert": ["malware","ads"]}→ wireguard.dns = 10.255.255.3
Garde-fous pour agents autonomes
Un agent qui suit un lien malveillant ou une instruction injectée ne peut toujours pas résoudre les domaines connus de malwares, de phishing ou de botnets.
Moins de données, moins de bruit
Le blocage des publicités et des traqueurs allège les pages : les agents dépensent moins de tokens et de bande passante pour du superflu.
Réglé par clé, via l'API
Les nouvelles clés démarrent avec le blocage des malwares activé. Modifiez les listes à tout moment avec :
PUT /vpn/wireguard/settings
Confidentialité et contrôle
Rien à créer, rien à divulguer
Zéro compte
L'API ne demande jamais qui vous êtes. Votre agent génère une paire de clés WireGuard, et la clé publique constitue toute l'identité. La clé privée ne quitte jamais la machine, et chaque requête qui gère la connexion est signée avec elle : gardez-la donc aussi privée que la connexion elle-même.
Votre agent paie tout seul
USDC sur Base, réglé à chaque requête via le standard ouvert x402. Pas de page de paiement, pas de carte enregistrée, et relancer un paiement ne débite jamais deux fois.
Compatible avec tout client WireGuard
Une requête signée avec votre clé renvoie l'adresse, le résolveur DNS et la clé pré-partagée : un seul modèle suffit pour générer une configuration wg-quick.
Renouveler, transférer ou mettre fin à l'accès
Achetez plus de temps, transférez l'accès vers une nouvelle clé ou révoquez-le immédiatement, chaque fois avec une seule requête signée.
Comment un agent achète un VPN avec x402
De zéro à un tunnel en quatre étapes
Du HTTP simple et le standard de paiement ouvert x402. N'importe quel client x402 v2 peut payer sans code personnalisé.
- 402
Demander une durée
Envoyez une clé publique WireGuard et un nombre de mois. La réponse indique le prix exact, le réseau et le bénéficiaire.
POST /vpn/wireguard
- x402
Payer le devis
Signez une autorisation de transfert USDC et renvoyez la même requête avec celle-ci.
PAYMENT-SIGNATURE: …
- 201
Générer la configuration
Une requête signée renvoie l'adresse, le résolveur DNS et la clé pré-partagée. Choisissez une sortie dans la liste des emplacements.
GET /vpn/wireguard/locations
- WG
Se connecter
Activez le tunnel avec n'importe quel client WireGuard et définissez les filtres dont la tâche a besoin.
wg-quick up ./windscribe.conf
Tarifs
Un seul prix, payé en USDC
Payé en USDC sur Base avec x402. Pas d'abonnement ni de renouvellement automatique : rachetez avec la même clé pour ajouter du temps, jusqu'à 12 mois d'avance. Les paiements sont définitifs.
Documentation pour développeurs et agents
Tout ce dont un agent a besoin pour démarrer
La spécification OpenAPI décrit chaque endpoint. llms.txt en est la version courte pour les agents.
Lis https://windscribe.com/vpn-api/llms.txt. Crée une paire de clés WireGuard sur cette machine, achète pour elle un mois d'accès au VPN Windscribe avec x402, active le blocage des malwares et des publicités, puis écris une configuration wg-quick pour l'emplacement le plus proche. Garde la clé privée sur cette machine.
- URL de base
- https://api.windscribe.com/vpn
- Découverte
- GET /vpn
- Paiement
- x402 v2, schéma exact, USDC sur Base
- Authentification
- Requêtes signées avec la clé WireGuard (wg-xeddsa-v1)
Explorer l'API9 endpoints, champs de requête et de réponse, code en cURL, Python et JavaScriptOuvrir
/vpn/wireguardBuy 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.
En-têtes
Corps de la requête · application/json
123456712Réponses
Payment settled and time bought
activeexpiredrevokedmalwareadssocialporngamblingfakenewscompetitorscryptominers123456712Les champs affichés se trouvent dans data.
# 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}'
{ "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" } }
Donnez à vos agents leur propre VPN.
Devis avec POST /vpn/wireguard, paiement avec x402, connexion avec WireGuard.
Questions
Avant d'acheter
Qu'est-ce que l'API VPN Windscribe ?
Une API HTTP qui vend un accès au VPN WireGuard de Windscribe directement à une clé publique WireGuard. Les agents IA, les scripts et les appareils peuvent acheter, utiliser et gérer une connexion sans compte Windscribe.
Un agent IA peut-il acheter un VPN tout seul ?
Oui. L'agent envoie sa clé publique WireGuard et une durée, reçoit un devis HTTP 402, le paie en USDC avec x402 et récupère les valeurs d'une configuration WireGuard. Personne n'a besoin de s'inscrire ni de confirmer quoi que ce soit.
Ai-je besoin d'un compte Windscribe ?
Non. L'API ne demande jamais d'e-mail, de mot de passe ni de session. Votre clé publique WireGuard identifie l'achat, et les requêtes qui le gèrent sont signées avec la clé privée correspondante.
Comment payer ?
En USDC sur Base, via x402 v2. La première requête renvoie le montant exact et l'adresse de réception ; votre client signe une autorisation de transfert USDC et renvoie la requête.
Est-ce un abonnement ?
Non. Chaque paiement achète une durée fixe de 1 à 7 ou 12 mois. Rachetez avec la même clé pour ajouter du temps, jusqu'à 12 mois d'avance.
Puis-je être remboursé ?
Non. Les paiements sont définitifs. Révoquer une clé met fin à l'accès immédiatement et fait perdre le temps restant ; racheter du temps réactive la clé.
Puis-je contrôler les domaines auxquels mon agent peut accéder ?
Oui. Chaque clé dispose de listes de filtrage DNS ROBERT : Malwares (y compris les serveurs de phishing et de botnets), Pubs + traqueurs, Réseaux sociaux, Porno, Jeux d'argent, Pièges à clics, Cryptos et Autres VPN. Les nouvelles clés démarrent avec Malwares activé, et PUT /vpn/wireguard/settings modifie les listes à tout moment. Les règles de domaines personnalisées ne sont pas prises en charge.
Quel protocole VPN utilise-t-elle ?
WireGuard. L'API renvoie l'adresse de l'interface, le résolveur DNS, la clé pré-partagée et le port du endpoint : n'importe quel client WireGuard, y compris wg-quick, peut se connecter.
Que stocke Windscribe ?
La clé publique, une clé pré-partagée générée, la date d'expiration, vos filtres ROBERT et, pour chaque paiement, les détails du produit, son état et le hash de la transaction de règlement. Windscribe ne stocke pas l'adresse de votre portefeuille, mais le règlement est public sur Base et révèle le portefeuille payeur.
Et si ma clé WireGuard est déjà utilisée ?
Une clé qui appartient à un compte Windscribe ou à un partenaire est refusée avec wireguard_key_exists avant tout mouvement d'argent. Générez une nouvelle clé et réessayez.
Quels serveurs puis-je utiliser ?
Les emplacements WireGuard premium renvoyés par GET /vpn/wireguard/locations tant que votre accès est actif. Les serveurs à IP statique ne sont pas inclus.