واجهة الوكلاء هي مرآة برمجية لعملية الدفع البشرية لدينا: يقرأ الوكيل ملف اكتشاف، ويُنشئ حساباً للحصول على رمز Bearer، ويطلب شحن الرصيد، ويتلقى استجابة HTTP 402 تتضمن كتلة accepts، ويوقّع دفعة USDC على Base، ويعيد الإرسال مع ترويسة X-PAYMENT، ثم ينفق الرصيد المُموّل على أي من بلداننا الـ 18 ومشغّلينا الـ 43. لا بطاقة، ولا PayPal، ولا خطوة موافقة بشرية.
ما الغرض من واجهة x402 + MCP؟
يُحيي x402 رمز الحالة الخامل HTTP 402 Payment Required كمصافحة دفع حقيقية: يُعيد الطلب غير المُصادَق عليه أو غير المُموّل رمز 402 مع كتلة accepts منظَّمة تصف بدقة كيفية الدفع، فيدفع الوكيل، ويُعيد إرسال الطلب نفسه مع إثبات الدفع. تُنفّذ Proxy4G هذا للإجراء الوحيد الذي يحتاج إلى أموال — تمويل رصيد المحفظة — بحيث يمكن لوكيل مستقل شراء بروكسيات 4G المحمولة من البداية إلى النهاية.
هذا هو الرصيد نفسه الموصوف في عملية الدفع بالعملات المشفّرة: يشحن البشر بـ Bitcoin أو Ethereum أو Solana أو USDT، بينما يشحن الوكلاء بـ USDC على Base عبر x402. وبمجرد التمويل، يشتري الرصيد خطط المخصّصة أو SOCKS5 عبر منطق الطلب نفسه. إذا كنت تبني بنية تحتية مستقلة، فراجع حالة استخدام وكلاء الذكاء الاصطناعي والأتمتة للاطّلاع على أنماط وقت التشغيل.
نظرة سريعة على واجهة الوكلاء
كيف يكتشف الوكيل واجهة API؟
قبل إجراء المعاملات، ينبغي للوكيل جلب الواصفات القابلة للقراءة آلياً حتى يتمكّن من تخطيط التدفق دون كشط HTML. تُقدَّم ثلاثة ملفات في جذر الموقع:
- /.well-known/agent.json — بطاقة الوكيل: القدرات، وقاعدة
/agent-api.php، ومخطط الدفع (x402،exact، USDC على Base). - /openapi.json — تعريف OpenAPI الكامل لكل إجراء (
account،topup، نقاط نهاية الطلب) مع أشكال الطلب/الاستجابة. - /llms.txt — خريطة نصية بسيطة للموقع موجَّهة لزواحف نماذج اللغة، مع ملف مرافق /pricing.md لجدول الأسعار لكل بلد.
الاكتشاف للقراءة فقط وغير مُصادَق عليه، بحيث يمكن للوكيل أن يقرّر ما إذا كان سيشتري وما الذي سيشتريه قبل أن يُنشئ حساباً أو يحرّك أموالاً على الإطلاق.
تدفق الشراء: التهيئة ← عرض السعر ← الدفع ← التزويد
- 1
التهيئة
يقرأ الوكيل agent.json وpricing.md، ثم يختار خطة من 18 بلداً / 43 مشغّلاً — مثل منفذ مخصّص US T-Mobile 5G، أو عنوان IP مشترك France Free Mobile يتناوب كل 5 دقائق.
- 2
الحساب
يُنشئ POST /agent-api.php?action=account حساباً بدون KYC عند أول استدعاء ويُعيد رمز Bearer. لا يُطلب التحقق من اسم أو عنوان أو هاتف أو بريد إلكتروني.
- 3
عرض السعر
يُعيد POST /agent-api.php?action=topup مع الترويسة X-Payment-Mode: x402 ودون إثبات دفع رمز HTTP 402 مع كتلة accepts (المخطط exact، الأصل USDC، الشبكة Base، المبلغ، عنوان payTo، nonce/الصلاحية).
- 4
الدفع
يوقّع الوكيل على transferWithAuthorization من نوع EIP-3009 لمبلغ USDC المُسعّر إلى عنوان payTo على Base، مُنتِجاً حمولة تفويض موقّعة.
- 5
التسوية
أعد إرسال طلب الشحن نفسه مع الترويسة X-PAYMENT الحاملة للتفويض الموقّع. وعند التحقق، يُضاف الرصيد وتُعيد الاستجابة رمز 200.
- 6
التزويد
يشتري الرصيد المُموّل الخطة المختارة. تُرسَل بيانات الاعتماد (HOST، PORT، اسم المستخدم، كلمة المرور) عبر البريد الإلكتروني خلال دقائق، ويصبح وصول HTTP/HTTPS/SOCKS5 فعّالاً مع عنوان IP لمشغّل بدرجة ثقة 100%.
الخطوة 1 — أنشئ حساباً واحصل على رمز Bearer
curl -s -X POST 'https://proxy4g.co/agent-api.php?action=account' \
-H 'Content-Type: application/json'
# 200 OK
# {
# "account_id": "acct_...",
# "token": "BEARER_TOKEN",
# "balance_usdc": "0.00"
# }الخطوة 2 — اطلب شحناً واستلم عرض سعر 402
curl -s -i -X POST 'https://proxy4g.co/agent-api.php?action=topup' \
-H 'Authorization: Bearer BEARER_TOKEN' \
-H 'X-Payment-Mode: x402' \
-H 'Content-Type: application/json' \
-d '{"amount_usd": 27}'
# HTTP/1.1 402 Payment Required
# {
# "x402Version": 1,
# "accepts": [{
# "scheme": "exact",
# "network": "base",
# "asset": "USDC",
# "maxAmountRequired": "27000000",
# "payTo": "0xYOUR_PAYTO_ADDRESS",
# "resource": "/agent-api.php?action=topup",
# "nonce": "0x...",
# "validUntil": 1748505600
# }]
# }الخطوة 3 — وقّع EIP-3009 وأعد الإرسال مع X-PAYMENT
# Sign an EIP-3009 transferWithAuthorization for the quoted USDC
# amount to payTo on Base, then base64 the payload into X-PAYMENT.
curl -s -X POST 'https://proxy4g.co/agent-api.php?action=topup' \
-H 'Authorization: Bearer BEARER_TOKEN' \
-H 'X-Payment-Mode: x402' \
-H 'X-PAYMENT: <base64 signed authorization>' \
-H 'Content-Type: application/json' \
-d '{"amount_usd": 27}'
# 200 OK -> balance credited; spend it on any plan.
# Verify a provisioned proxy:
# curl -x http://USER:PASS@HOST:PORT https://api.ipify.orgما يرثه تدفق الوكلاء من التدفق البشري
- بدون KYC: لا هوية حكومية، ولا اسم أو عنوان، ولا هاتف، ولا تحقق من البريد الإلكتروني — يُنشأ الحساب تلقائياً عند أول استدعاء
- عناوين IP حقيقية لمشغّلين على بطاقات SIM فعلية عبر 18 بلداً و43 مشغّلاً، بدرجة ثقة 100%
- منطق الخطط نفسه: مخصّص (تناوب عند الطلب أو تلقائياً كل 1–60 دقيقة) أو مشترك (تناوب تلقائي كل 5 دقائق)
- جميع البروتوكولات الثلاثة: HTTP وHTTPS وSOCKS5، مع مصادقة باسم المستخدم/كلمة المرور أو القائمة البيضاء لعناوين IP
- لا نُسجّل حركة مرور الوجهة — مشتريات الوكلاء لا تحمل أي قياسات إضافية
ابنِ باستخدام واجهة الوكلاء
وكلاء الذكاء الاصطناعي والأتمتة
أنماط وقت التشغيل للوكلاء المستقلين الذين يشترون بروكسيات محمولة ويتناوبونها.
اشترِ بروكسيات بالعملات المشفّرة
الجانب البشري للرصيد نفسه: شحن بـ BTC وETH وSOL وUSDT.
التسعير لكل بلد
مخصّص بدءاً من $27/mo، مشترك بدءاً من $10.80/mo — جدول كامل، قابل للقراءة آلياً عبر /pricing.md.
الأسئلة الشائعة
x402 هو بروتوكول دفع مبني على رمز الحالة HTTP 402 Payment Required. يُعيد الطلب الذي يحتاج إلى أموال رمز 402 مع كتلة accepts منظَّمة تصف كيفية الدفع؛ يدفع العميل ويعيد إرسال الطلب مع إثبات الدفع. تستخدمه Proxy4G بحيث يمكن للوكلاء المستقلين تمويل رصيد بـ USDC على Base وشراء بروكسيات محمولة دون أي خطوة دفع بشرية.
المخطط هو exact، والأصل هو USDC، وتتم التسوية على شبكة Base. يوقّع الوكيل على transferWithAuthorization من نوع EIP-3009 للمبلغ المُسعّر إلى عنوان payTo المُعاد في استجابة 402، ثم يعيد إرسال الطلب مع ذلك التفويض الموقّع في الترويسة X-PAYMENT.
لا. يرث تدفق الوكلاء نموذج بدون KYC لدينا: لا هوية حكومية، ولا اسم أو عنوان، ولا هاتف، ولا تحقق من البريد الإلكتروني. يُنشأ الحساب تلقائياً عند أول استدعاء action=account، ولا نُسجّل حركة مرور الوجهة.
اجلب الواصفات المُقدَّمة في جذر الموقع: /.well-known/agent.json لبطاقة الوكيل ومخطط الدفع، و/openapi.json لمخططات الإجراءات الكاملة، و/llms.txt إضافة إلى /pricing.md لخريطة الموقع وجدول الأسعار. كل عمليات الاكتشاف للقراءة فقط وغير مُصادَق عليها.
الشيء نفسه الذي يحصل عليه المشتري البشري: بيانات اعتماد البروكسي — المضيف، والمنفذ، واسم المستخدم، وكلمة المرور — تُرسَل عبر البريد الإلكتروني خلال دقائق من الطلب. يدعم البروكسي HTTP وHTTPS وSOCKS5، مع مصادقة باسم المستخدم/كلمة المرور أو القائمة البيضاء لعناوين IP، على عنوان IP حقيقي لمشغّل من أحد 18 بلداً و43 مشغّلاً.
نعم. يُضيف الشحن رصيداً إلى محفظة، وليس إلى طلب واحد. بمجرد التمويل بـ USDC على Base، يمكن للوكيل تقديم طلبات متعددة مقابل ذلك الرصيد — على سبيل المثال عدة منافذ مخصّصة عبر بلدان مختلفة — وإعادة الشحن بدورة x402 أخرى كلما انخفض الرصيد.