تخطَّ إلى المحتوى الرئيسي
Windscribe

واجهة VPN APIالخاصةواجهة VPN APIالخاصة بوكلائك.

امنح وكلاء الذكاء الاصطناعي لديك شبكة WireGuard VPN خاصة بهم. يشترونها بعملة USDC في استدعاء API واحد، ويحظرون النطاقات الضارة بفلترة DNS، ولا يحتاجون إلى حساب أبدًا.

أيها الوكلاء: ابدؤوا من llms.txt. عنوان URL الأساسي https://api.windscribe.com/vpn

حالات الاستخدام

ماذا يفعل الوكلاء بـ VPN خاص بهم

يعمل الوكلاء على الإنترنت المفتوح نيابةً عنك. هذه هي المهام التي يهم فيها وجود اتصال خاص وقابل للتحكم.

  • الخصوصية

    تصفّح بخصوصية

    ترى المواقع عنوان IP من Windscribe، ولا ترى أبدًا شبكة منزلك أو مكتبك.

  • الاختبار الجغرافي

    شاهد من بلد آخر

    تحقّق من الأسعار المحلية ونتائج البحث كما يراها الناس هناك.

  • الأمان

    أمّن أي شبكة

    تحصل شبكات Wi-Fi في الفنادق والروبوتات والأجهزة الطرفية على نفق WireGuard مشفّر.

  • المنصات

    نفق لكل عميل

    مفتاح واحد وفترة واحدة لكل مساحة عمل أو مهمة. لا حسابات تحتاج إلى إدارتها.

فلترة DNS مع ROBERT

تحكّم فيما يمكن لوكيلك الوصول إليه

احظر نطاقات البرمجيات الخبيثة والتصيّد حتى لا يمكن توجيه الوكيل إليها، أو تخلّص من الإعلانات وأدوات التتبع لتقليل الضوضاء واستهلاك البيانات. طلب API واحد يغيّر القوائم لمفتاح ما، ويطبّقها محلّل DNS الخاص بالنفق.

قوائم الفلترة
استعلامات DNSتم حظر 3 من أصل 9
  1. search.engine.example
  2. shocking.headlines.example
  3. miner.hashpool.example
  4. sync.tracker.exampleالإعلانات + أدوات التتبعمحظور
  5. shop.retailer.example
  6. odds.casino.example
  7. c2.botnet.exampleالبرمجيات الخبيثةمحظور
  8. ads.network.exampleالإعلانات + أدوات التتبعمحظور
  9. cdn.images.example

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

ضوابط أمان للوكلاء المستقلين

حتى الوكيل الذي يتبع رابطًا ضارًا أو تعليمات محقونة لا يمكنه تحليل نطاقات معروفة للبرمجيات الخبيثة أو التصيّد أو شبكات البوتنت.

بيانات أقل، ضوضاء أقل

حظر الإعلانات وأدوات التتبع يجعل الصفحات أخف، فيستهلك الوكلاء رموزًا (tokens) وعرض نطاق أقل على المحتوى غير المفيد.

إعداد لكل مفتاح عبر API

تبدأ المفاتيح الجديدة وحظر البرمجيات الخبيثة مفعّل. غيّر القوائم في أي وقت باستخدام:

PUT /vpn/wireguard/settings

الخصوصية والتحكم

لا شيء للتسجيل فيه، ولا شيء ليتسرّب

الهوية

بلا حسابات إطلاقًا

لا تسألك API أبدًا عن هويتك. ينشئ وكيلك زوج مفاتيح WireGuard، والمفتاح العام هو الهوية بأكملها. لا يغادر المفتاح الخاص الجهاز أبدًا، وكل طلب لإدارة الاتصال يُوقَّع به، لذا احفظه بالسرية نفسها التي يتمتع بها الاتصال.

البريد الإلكترونيكلمة المرورالبطاقةالجلسةwg_pubkey ✓
مدفوعات x402

وكيلك يدفع بنفسه

USDC على شبكة Base، تتم تسويتها لكل طلب عبر معيار x402 المفتوح. لا صفحة دفع، ولا بطاقة محفوظة، وإعادة محاولة الدفع لا تخصم المبلغ مرتين أبدًا.

WireGuard قياسي

يعمل مع أي عميل WireGuard

يعيد طلب موقَّع بمفتاحك العنوان ومحلّل DNS والمفتاح المشترك مسبقًا، لذا يكفي قالب واحد لبناء إعداد wg-quick.

تحكم كامل عبر API

جدّد الوصول أو انقله أو أنهِه

اشترِ وقتًا إضافيًا، أو انقل الوصول إلى مفتاح جديد، أو ألغِه فورًا، وكل ذلك بطلب موقَّع واحد.

كيف يشتري الوكيل VPN عبر x402

من لا شيء إلى نفق في أربع خطوات

HTTP عادي ومعيار الدفع المفتوح x402. يمكن لأي عميل x402 v2 الدفع دون شيفرة مخصّصة.

  1. 402

    اطلب فترة

    أرسل مفتاح WireGuard عامًا وعدد الأشهر. يتضمن الرد السعر الدقيق والشبكة والجهة المستفيدة.

    POST /vpn/wireguard

  2. x402

    ادفع عرض السعر

    وقّع تفويض تحويل USDC وأرسل الطلب نفسه مرة أخرى مرفقًا به.

    PAYMENT-SIGNATURE: …

  3. 201

    أنشئ الإعداد

    يعيد طلب موقَّع العنوان ومحلّل DNS والمفتاح المشترك مسبقًا. اختر نقطة خروج من قائمة المواقع.

    GET /vpn/wireguard/locations

  4. WG

    اتصل

    شغّل النفق بأي عميل WireGuard واضبط الفلاتر التي تحتاجها المهمة.

    wg-quick up ./windscribe.conf

الأسعار

سعر واحد، يُدفع بعملة USDC

يُدفع بعملة USDC على شبكة Base عبر x402. لا اشتراك ولا تجديد تلقائي: اشترِ مرة أخرى بالمفتاح نفسه لإضافة وقت، حتى 12 شهرًا مقدمًا. المدفوعات نهائية.

شهري$0
سنويوفّر $39$0

وثائق للمطورين والوكلاء

كل ما يحتاجه الوكيل للبدء

تصف مواصفات OpenAPI كل نقطة نهاية. أما llms.txt فهو النسخة المختصرة للوكلاء.

سلّم هذا إلى وكيلك
اقرأ https://windscribe.com/vpn-api/llms.txt.
أنشئ زوج مفاتيح WireGuard على هذا الجهاز، واشترِ له شهرًا واحدًا من الوصول إلى Windscribe VPN عبر x402، وفعّل حظر البرمجيات الخبيثة والإعلانات، ثم اكتب إعداد wg-quick لأقرب موقع. احتفظ بالمفتاح الخاص على هذا الجهاز.
نظرة سريعة
عنوان URL الأساسي
https://api.windscribe.com/vpn
الاكتشاف
GET /vpn
الدفع
x402 v2، مخطط exact، USDC على شبكة Base
المصادقة
طلبات موقَّعة بمفتاح WireGuard (wg-xeddsa-v1)
استكشف API9 نقاط نهاية، وحقول الطلبات والاستجابات، وشيفرة بلغات cURL وPython وJavaScriptفتح
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.

التوقيع اختياريx402 · USDC على شبكة BasebuyWireGuardTime

الترويسات

الترويسة
مطلوب
الوصف
PAYMENT-SIGNATURE
لا
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
لا
Part of the optional purchase signature.
Content-Digest
لا
Part of the optional purchase signature.
Signature-Input
لا
Part of the optional purchase signature.
Signature
لا
Part of the optional purchase signature.

نص الطلب · application/json

الحقل
النوع
الوصف
wg_pubkeyمطلوب
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.
monthsمطلوب
integer
123456712

الاستجابات

Payment settled and time bought

الحقل
النوع
الوصف
pubkeyمطلوب
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.
statusمطلوب
string
activeexpiredrevoked
expiresمطلوب
integer
Unix seconds; access ends exactly then.
ipv4مطلوب
string
ipv6مطلوب
string
robertمطلوب
string[]
malwareadssocialporngamblingfakenewscompetitorscryptominers
wireguardمطلوب
object
[Interface] values; the [Peer] comes from a locations group and node.
wireguard.addressمطلوب
string
Interface IPv4 address with prefix, derived from the public key.
wireguard.address_v6مطلوب
string
Interface IPv6 address with prefix, derived from the public key.
wireguard.dnsمطلوب
string
Windscribe resolver for the current ROBERT filters.
wireguard.allowed_ipsمطلوب
"0.0.0.0/0, ::/0"
wireguard.endpoint_portمطلوب
443
purchasable_termsمطلوب
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.
successمطلوب
1
payment_idمطلوب
string | null
Null when rotate moved an active entitlement.
settlement_referenceمطلوب
string | null
Base transaction hash of the settlement.

الحقول المعروضة موجودة داخل 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}'
مثال على الاستجابة · 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

امنح وكلاءك VPN خاصًا بهم.

اطلب عرض سعر عبر POST /vpn/wireguard، وادفع عبر x402، واتصل عبر WireGuard.

All Your Devices

الأسئلة

قبل أن تشتري

ما هي Windscribe VPN API؟

واجهة HTTP API تبيع الوصول إلى Windscribe WireGuard VPN مباشرةً لمفتاح WireGuard عام. يمكن لوكلاء الذكاء الاصطناعي والسكربتات والأجهزة شراء اتصال واستخدامه وإدارته دون حساب Windscribe.

هل يمكن لوكيل ذكاء اصطناعي شراء VPN بمفرده؟

نعم. يرسل الوكيل مفتاح WireGuard العام الخاص به وفترة، فيتلقى عرض سعر HTTP 402، ويدفعه بعملة USDC عبر x402، ويستلم القيم اللازمة لإعداد WireGuard. لا يحتاج أي شخص إلى التسجيل أو تأكيد أي شيء.

هل أحتاج إلى حساب Windscribe؟

لا. لا تطلب API أبدًا بريدًا إلكترونيًا أو كلمة مرور أو جلسة. يحدّد مفتاح WireGuard العام الخاص بك عملية الشراء، وتُوقَّع الطلبات التي تديرها بالمفتاح الخاص المطابق.

كيف أدفع؟

بعملة USDC على شبكة Base، عبر x402 v2. يعيد الطلب الأول المبلغ الدقيق وعنوان الاستلام؛ يوقّع العميل لديك تفويض تحويل USDC ويرسل الطلب مرة أخرى.

هل هو اشتراك؟

لا. كل دفعة تشتري فترة ثابتة من 1 إلى 7 أو 12 شهرًا. اشترِ مرة أخرى بالمفتاح نفسه لإضافة وقت، حتى 12 شهرًا مقدمًا.

هل يمكنني استرداد أموالي؟

لا. المدفوعات نهائية. إلغاء المفتاح ينهي الوصول فورًا ويُسقط الوقت المتبقي؛ وشراء وقت مرة أخرى يعيد تفعيل المفتاح.

هل يمكنني التحكم في النطاقات التي يستطيع وكيلي الوصول إليها؟

نعم. لكل مفتاح قوائم فلترة DNS من ROBERT: البرمجيات الخبيثة (بما فيها خوادم التصيّد وشبكات البوتنت)، والإعلانات + أدوات التتبع، والشبكات الاجتماعية، والإباحية، والقمار، والطُّعم النقري، والعملات المشفرة، وشبكات VPN الأخرى. تبدأ المفاتيح الجديدة مع تفعيل البرمجيات الخبيثة، ويغيّر PUT /vpn/wireguard/settings القوائم في أي وقت. القواعد المخصّصة للنطاقات غير مدعومة.

ما بروتوكول VPN المستخدم؟

WireGuard. تعيد API عنوان الواجهة ومحلّل DNS والمفتاح المشترك مسبقًا ومنفذ نقطة النهاية، لذا يمكن لأي عميل WireGuard، بما في ذلك wg-quick، الاتصال.

ما الذي تخزّنه Windscribe؟

المفتاح العام، ومفتاحًا مشتركًا مسبقًا مُنشأً، وتاريخ الانتهاء، وفلاتر ROBERT الخاصة بك، ولكل دفعة تفاصيل المنتج وحالتها وتجزئة (hash) معاملة التسوية. لا تخزّن Windscribe عنوان محفظتك، لكن التسوية علنية على شبكة Base وتُظهر المحفظة الدافعة.

ماذا لو كان مفتاح WireGuard الخاص بي مستخدمًا بالفعل؟

يُرفض المفتاح الذي يخص حساب Windscribe أو شريكًا مع الخطأ wireguard_key_exists قبل تحويل أي أموال. أنشئ مفتاحًا جديدًا وحاول مرة أخرى.

ما الخوادم التي يمكنني استخدامها؟

مواقع WireGuard المميزة التي يعيدها GET /vpn/wireguard/locations طالما أن وصولك نشط. خوادم IP الثابت غير مشمولة.