الوكيل ينتمي إلى صنف HTTParty الخاص بك

عندما يضمّن صنف Ruby وحدة HTTParty، ضع الوكيل على ذلك الصنف واجعل الطلبات تمر عبره:

class Reports
  include HTTParty
  http_proxy 'proxy.example', 8080
end

response = Reports.get('https://reports.example/monthly')

يفترض المثال أن HTTParty محمّلة. تأخذ دالة الوكيل اسم مضيف ومنفذًا صحيحًا، مع وسيطتي اسم مستخدم وكلمة مرور اختياريتين. لاختبار مسموح به لواجهة API عامة دون حساب وكيل، استخدم مرشح HTTP من قائمة وكلاء HTTP للمضيف والمنفذ. أبقِ عنوان URL الوجهة على get.

داخل دالة مثيل من Reports، استخدم self.class.get(...) عندما تكون النية استدعاء دالة الصنف المهيّأة تلك. أما استدعاء وحدة HTTParty العليا فيمكن أن يتجاوز الغلاف الذي هيّأت افتراضاته للتو.

التمييز نفسه مهم عندما تتشارك عدة أغلفة API تطبيقًا واحدًا. أعطِ كل واحد سياسة الوكيل المقصودة له بدلًا من تغيير HTTParty::Basement عالميًا لإصلاح صنف واحد.

يكشف HTTParty أيضًا خيارات وكيل لكل طلب مثل http_proxyaddr وhttp_proxyport. استخدمها عندما يكون المسار جزءًا حقيقيًا من طلب واحد. افتراضات الصنف أسهل في القراءة عندما يجب أن تتبع كل عملية Reports المسار نفسه.