تمرير جلسة وكيل إلى Dropbox Python SDK

يقبل Dropbox Python SDK جلسة HTTP مُهيأة. وتتضمن دالة المساعدة العامة create_session وسيطًا باسم proxies:

import dropbox

session = dropbox.create_session(proxies={
    'https': 'http://proxy.example:8080',
})
client = dropbox.Dropbox(access_token, session=session)

تُرجع دالة المساعدة في SDK جلسة Requests تحمل إعداد مجموعة اتصالات SDK. وتمرير ذلك الكائن إلى Dropbox يربطه بطبقة النقل الخاصة بواجهة API للعميل؛ فلا حاجة إلى تعديل dropbox/rest.py أو استبدال فئة pool-manager خاصة.

يحدد مفتاح القاموس وجهات HTTPS. ويصف عنوان HTTP URL مستمع هذا الوكيل المثال. قدّم access token المعتاد للتطبيق بشكل منفصل عبر مُنشئ العميل. وتوفر قائمة وكلاء HTTP مرشحات نقاط نهاية لمسار Dropbox API عام مسموح به دون مصادقة وكيل؛ لكنها لا توفر ذلك access token.

لا يزال دمج بيئة Requests ينطبق على الجلسة. وإذا كان التطبيق يملك المسار الكامل عن قصد، فاضبط session.trust_env على false وقدّم أي إعداد ثقة يعتمد على البيئة بشكل صريح. وإلا فاحتفظ بسلوك البيئة الذي يتطلبه النشر.

تقبل دالة المساعدة أيضًا ca_certs لحزمة CA مختارة. أبقِ إنشاء الجلسة في مكان واحد وأعد استخدام العميل الناتج لعملياته المقصودة، حتى تتشارك طلبات البيانات الوصفية ونقل الملفات طبقة النقل المهيأة نفسها.