Saltar para o conteúdo principal
Windscribe

A API de VPNpara seusA API de VPNpara seus agentes.

Dê aos seus agentes de IA a própria VPN WireGuard. Eles a compram com USDC em uma única chamada de API, bloqueiam domínios maliciosos com filtragem de DNS e nunca precisam de uma conta.

Agentes: comecem em llms.txt. URL base https://api.windscribe.com/vpn

Casos de uso

O que os agentes fazem com a própria VPN

Agentes agem na web aberta por você. Estas são as tarefas em que uma conexão privada e controlável faz diferença.

  • Privacidade

    Navegue com privacidade

    Os sites veem um IP da Windscribe, nunca a rede da sua casa ou do seu escritório.

  • Testes geográficos

    Veja outro país

    Confira preços locais e resultados de busca do jeito que as pessoas de lá veem.

  • Segurança

    Proteja qualquer rede

    Wi-Fi de hotel, robôs e dispositivos de borda ganham um túnel WireGuard criptografado.

  • Plataformas

    Um túnel por cliente

    Uma chave e um período por workspace ou tarefa. Nenhuma conta para gerenciar.

Filtragem de DNS com o ROBERT

Limite o que seu agente pode acessar

Bloqueie domínios de malware e phishing para que um agente não possa ser levado até eles, ou elimine anúncios e rastreadores para reduzir o ruído e o consumo de dados. Uma única requisição à API troca as listas de uma chave, e o resolvedor de DNS do túnel as aplica.

Listas de filtros
Consultas de DNS3 de 9 bloqueadas
  1. search.engine.example
  2. shocking.headlines.example
  3. miner.hashpool.example
  4. sync.tracker.exampleAnúncios + rastreadoresBLOQUEADO
  5. shop.retailer.example
  6. odds.casino.example
  7. c2.botnet.exampleMalwaresBLOQUEADO
  8. ads.network.exampleAnúncios + rastreadoresBLOQUEADO
  9. cdn.images.example

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

Proteções para agentes autônomos

Um agente que segue um link malicioso ou uma instrução injetada ainda assim não consegue resolver domínios conhecidos de malware, phishing ou botnets.

Menos dados, menos ruído

Bloquear anúncios e rastreadores deixa as páginas mais leves, então os agentes gastam menos tokens e menos banda com tralha.

Definido por chave, via API

Chaves novas começam com o bloqueio de malware ativado. Mude as listas quando quiser com:

PUT /vpn/wireguard/settings

Privacidade e controle

Nada para cadastrar, nada para vazar

Identidade

Zero contas

A API nunca pergunta quem você é. Seu agente gera um par de chaves WireGuard, e a chave pública é toda a identidade. A chave privada nunca sai da máquina, e toda requisição que gerencia a conexão é assinada com ela, então mantenha-a tão privada quanto a própria conexão.

e-mailsenhacartãosessãowg_pubkey ✓
Pagamentos x402

Seu agente paga sozinho

USDC na Base, liquidado por requisição pelo padrão aberto x402. Sem página de checkout, sem cartão salvo, e repetir um pagamento nunca cobra duas vezes.

WireGuard padrão

Funciona com qualquer cliente WireGuard

Uma requisição assinada com sua chave retorna o endereço, o resolvedor de DNS e a chave pré-compartilhada, então montar uma configuração do wg-quick exige um único modelo.

Controle total via API

Renove, transfira ou encerre o acesso

Compre mais tempo, transfira o acesso para uma nova chave ou revogue-o na hora, cada um com uma única requisição assinada.

Como um agente compra uma VPN com x402

Do zero a um túnel em quatro passos

HTTP puro e o padrão aberto de pagamento x402. Qualquer cliente x402 v2 consegue pagar sem código personalizado.

  1. 402

    Peça um período

    Envie uma chave pública WireGuard e um número de meses. A resposta traz o preço exato, a rede e o recebedor.

    POST /vpn/wireguard

  2. x402

    Pague o orçamento

    Assine uma autorização de transferência de USDC e envie a mesma requisição de novo com ela.

    PAYMENT-SIGNATURE: …

  3. 201

    Monte a configuração

    Uma requisição assinada retorna o endereço, o resolvedor de DNS e a chave pré-compartilhada. Escolha uma saída na lista de localizações.

    GET /vpn/wireguard/locations

  4. WG

    Conecte-se

    Suba o túnel com qualquer cliente WireGuard e defina os filtros de que a tarefa precisa.

    wg-quick up ./windscribe.conf

Preços

Um preço, pago em USDC

Pago em USDC na Base com x402. Sem assinatura e sem renovação automática: compre de novo com a mesma chave para adicionar tempo, até 12 meses à frente. Os pagamentos são definitivos.

MensalUS$ 0
AnualEconomize US$ 39US$ 0

Documentação para desenvolvedores e agentes

Tudo de que um agente precisa para começar

A especificação OpenAPI descreve cada endpoint. O llms.txt é a versão curta para agentes.

Entregue isto ao seu agente
Leia https://windscribe.com/vpn-api/llms.txt.
Crie um par de chaves WireGuard nesta máquina, compre para ela um mês de acesso à VPN da Windscribe com x402, ative o bloqueio de malware e de anúncios e depois escreva uma configuração do wg-quick para a localização mais próxima. Mantenha a chave privada nesta máquina.
Resumo rápido
URL base
https://api.windscribe.com/vpn
Descoberta
GET /vpn
Pagamento
x402 v2, esquema exact, USDC na Base
Autenticação
Requisições assinadas com a chave WireGuard (wg-xeddsa-v1)
Explore a API9 endpoints, campos de requisição e resposta, código em cURL, Python e JavaScriptAbrir
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.

Assinatura opcionalx402 · USDC na BasebuyWireGuardTime

Cabeçalhos

Cabeçalho
Obrigatório
Descrição
PAYMENT-SIGNATURE
não
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
não
Part of the optional purchase signature.
Content-Digest
não
Part of the optional purchase signature.
Signature-Input
não
Part of the optional purchase signature.
Signature
não
Part of the optional purchase signature.

Corpo da requisição · application/json

Campo
Tipo
Descrição
wg_pubkeyobrigatório
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.
monthsobrigatório
integer
123456712

Respostas

Payment settled and time bought

Campo
Tipo
Descrição
pubkeyobrigatório
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.
statusobrigatório
string
activeexpiredrevoked
expiresobrigatório
integer
Unix seconds; access ends exactly then.
ipv4obrigatório
string
ipv6obrigatório
string
robertobrigatório
string[]
malwareadssocialporngamblingfakenewscompetitorscryptominers
wireguardobrigatório
object
[Interface] values; the [Peer] comes from a locations group and node.
wireguard.addressobrigatório
string
Interface IPv4 address with prefix, derived from the public key.
wireguard.address_v6obrigatório
string
Interface IPv6 address with prefix, derived from the public key.
wireguard.dnsobrigatório
string
Windscribe resolver for the current ROBERT filters.
wireguard.allowed_ipsobrigatório
"0.0.0.0/0, ::/0"
wireguard.endpoint_portobrigatório
443
purchasable_termsobrigatório
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.
successobrigatório
1
payment_idobrigatório
string | null
Null when rotate moved an active entitlement.
settlement_referenceobrigatório
string | null
Base transaction hash of the settlement.

Os campos exibidos ficam dentro de data.

Requisição
# 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}'
Exemplo de resposta · 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

Dê aos seus agentes a própria VPN deles.

Peça o orçamento com POST /vpn/wireguard, pague com x402 e conecte-se com WireGuard.

All Your Devices

Perguntas

Antes de comprar

O que é a API de VPN da Windscribe?

Uma API HTTP que vende acesso à VPN WireGuard da Windscribe diretamente para uma chave pública WireGuard. Agentes de IA, scripts e dispositivos podem comprar, usar e gerenciar uma conexão sem uma conta Windscribe.

Um agente de IA pode comprar uma VPN sozinho?

Sim. O agente envia sua chave pública WireGuard e um período, recebe um orçamento HTTP 402, paga em USDC com x402 e recebe de volta os valores para uma configuração WireGuard. Nenhuma pessoa precisa se cadastrar ou confirmar nada.

Preciso de uma conta Windscribe?

Não. A API nunca pede e-mail, senha ou sessão. Sua chave pública WireGuard identifica a compra, e as requisições que a gerenciam são assinadas com a chave privada correspondente.

Como eu pago?

Com USDC na Base, via x402 v2. A primeira requisição retorna o valor exato e o endereço de recebimento; seu cliente assina uma autorização de transferência de USDC e envia a requisição de novo.

É uma assinatura?

Não. Cada pagamento compra um período fixo de 1 a 7 ou 12 meses. Compre de novo com a mesma chave para adicionar tempo, até 12 meses à frente.

Posso pedir reembolso?

Não. Os pagamentos são definitivos. Revogar uma chave encerra o acesso na hora e faz você perder o tempo restante; comprar tempo de novo reativa a chave.

Posso controlar quais domínios meu agente pode acessar?

Sim. Cada chave tem listas de filtros de DNS do ROBERT: Malwares (incluindo servidores de phishing e botnets), Anúncios + rastreadores, Redes sociais, Pornografia, Jogos de azar, Caça-cliques, Cripto e Outras VPNs. Chaves novas começam com Malwares ativado, e PUT /vpn/wireguard/settings altera as listas a qualquer momento. Regras de domínio personalizadas não são suportadas.

Qual protocolo de VPN ela usa?

WireGuard. A API retorna o endereço da interface, o resolvedor de DNS, a chave pré-compartilhada e a porta do endpoint, então qualquer cliente WireGuard, incluindo o wg-quick, consegue se conectar.

O que a Windscribe armazena?

A chave pública, uma chave pré-compartilhada gerada, a data de expiração, seus filtros do ROBERT e, para cada pagamento, os detalhes do produto, o status e o hash da transação de liquidação. A Windscribe não armazena o endereço da sua carteira, mas a liquidação é pública na Base e mostra a carteira pagadora.

E se minha chave WireGuard já estiver em uso?

Uma chave que pertence a uma conta Windscribe ou a um parceiro é recusada com wireguard_key_exists antes de qualquer dinheiro ser movimentado. Gere uma chave nova e tente de novo.

Quais servidores posso usar?

As localizações WireGuard premium retornadas por GET /vpn/wireguard/locations enquanto seu acesso estiver ativo. Servidores de IP estático não estão incluídos.