HTTP 402 Payment Required: معناه وكيف يستخدمه x402
402 هو رمز حالة HTTP للطلب الذي يتطلب الدفع قبل أن ينفّذه الخادم. طوال معظم تاريخه لم تكن له صيغة قياسية، وx402 يمنحه هذه الصيغة.
Key takeaways
-
402 Payment Required خطأ من جهة العميل: الطلب صالح، لكن الخادم يريد الدفع أولًا.
-
حجز HTTP/1.1 الرمز 402 للاستخدام المستقبلي ولم يحدد قط كيف يجب أن يتم الدفع، فاستخدمته كل واجهة API بطريقة مختلفة.
-
يحدد x402 العناصر الناقصة: ترويسة PAYMENT-REQUIRED بشروط قابلة للقراءة آليًا، ودفعة موقَّعة عند إعادة المحاولة.
معنى 402 Payment Required
تخبر استجابة 402 العميلَ أن الطلب نفسه سليم، لكنه لن يُنفَّذ حتى يتم الدفع. وينتمي إلى فئة 4xx لأن الخطوة التالية تقع على عاتق العميل وليس الخادم.
يختلف 402 عن 401 Unauthorized و403 Forbidden. فالرمز 401 يطلب بيانات اعتماد، و403 يرفض الطلب رفضًا قاطعًا، أما 402 فيطلب الدفع.
لماذا بقي 402 دون استخدام طويلًا
حُجز الرمز عند كتابة HTTP/1.1 على أمل أن يظهر لاحقًا شكل من أشكال النقد الرقمي. لكن المواصفة لم تحدد قط ما يجب أن يحتويه نص استجابة 402 ولا كيف يدفع العميل، فلم تتعامل معه المتصفحات أبدًا.
في غياب صيغة مشتركة، استخدمت واجهات API التي أرجعت 402 هذا الرمز خطأً عاديًا: نفاد رصيد الحساب، أو رفض البطاقة، أو بلوغ حد الخطة.
متى تُرجع واجهات API الرمز 402 اليوم
ستصادف 402 في حالتين رئيسيتين.
- أخطاء فوترة الحساب: المفتاح صالح لكن الرصيد أو الحصة أو الاشتراك لا يغطي الطلب. والحل هو إعادة الشحن أو الترقية.
- عروض أسعار الدفع لكل طلب: يُرجع الخادم شروط الدفع، ويستطيع العميل الدفع وإعادة إرسال الطلب نفسه. وهذه هي طريقة عمل x402.
كيف يحوّل x402 الرمز 402 إلى تدفق دفع
يضع x402 شروطًا قابلة للقراءة آليًا في ترويسة PAYMENT-REQUIRED: المبلغ والأصل والشبكة والمستلم. يوقّع العميل تفويضًا بعملة مستقرة وفق هذه الشروط، ويعيده في ترويسة PAYMENT-SIGNATURE، ثم يتلقى الاستجابة مع إيصال PAYMENT-RESPONSE.
ولأن التبادل كله يجري عبر HTTP عادي، يستطيع وكيل ذكاء اصطناعي يملك محفظة أن يدفع مقابل استدعاء API دون تسجيل أو تخزين مفتاح API.
التعامل مع 402 في عميلك
تحقق أولًا من وجود ترويسة PAYMENT-REQUIRED. إن وُجدت، فالاستجابة عرض سعر x402 ويمكن لعميل x402 دفعه. وإن لم توجد، فاقرأ نص الخطأ: فهو يعني عادةً أن الحساب يحتاج إلى رصيد إضافي أو خطة مختلفة.
الأسئلة الشائعة حول HTTP 402
هل 402 Payment Required خطأ؟
هو خطأ من جهة العميل ضمن نطاق 4xx، لكنه لا يعني أن الطلب مشوَّه. بل يعني أن الدفع مطلوب قبل أن يتابع الخادم.
ما الفرق بين 402 و401؟
يعني 401 أن الخادم يحتاج إلى بيانات اعتماد صالحة، ويعني 402 أن الخادم يحتاج إلى الدفع. قد تُرجع واجهة API الرمز 401 لمفتاح غير صالح، و402 لمفتاح صالح بلا رصيد.
هل تتعامل المتصفحات مع 402 تلقائيًا؟
لا. تعرض المتصفحات 402 مثل أي صفحة خطأ أخرى. ويتطلب الدفع التلقائي عميلًا يفهم بروتوكولًا مثل x402.
ما واجهات API التي تستخدم 402 مع x402؟
أي خادم ينفّذ بروتوكول x402. تُرجع RunAPI عروض أسعار x402 على نقاط نهاية نماذج الذكاء الاصطناعي المسعّرة لكل استدعاء، فيستطيع الوكيل دفع ثمن توليد الصور والفيديو والموسيقى والصوت بـ USDC.
صفحات ذات صلة
جرّب 402 يمكنك دفعه فعلًا
أرسل طلبًا إلى نقطة نهاية في RunAPI مسعّرة لكل استدعاء دون مفتاح، واطّلع على عرض سعر x402 الذي تُرجعه.