نظرة عامة

تتم استضافة مكتبة برامج Python على GitHub، وتتوفّر الحزمة على PpyPI.

قدم الإصدار 10.0.0 من مكتبة العميل عددًا من تغييرات الواجهة التي تم توثيقها في القسم إصدار 10.0.0 من المكتبة.

المتطلبات

تتطلب المكتبة وجود Python 3.7 أو إصدار أحدث. تجدر الإشارة إلى أنه تم إيقاف التوافق مع Python 2 في الإصدار 4.0.0 من المكتبة. لمزيد من المعلومات، اطّلع على مشاركة المدونة هذه.

المتطلبات الأساسية

قبل تثبيت المكتبة، ستحتاج إلى رمز مميز للمطوِّر والرقم التعريفي للعميل. وتتوفّر تعليمات حول كيفية الحصول عليها في القسم المتطلبات الأساسية. لاحظ أنك ستنشئ الرموز المميزة الأخرى المطلوبة لبروتوكول OAuth2 في خطوات لاحقة.

تثبيت

اتّبع التعليمات الواردة في مستندات التثبيت لتثبيت المكتبة من PyPi والعودة إلى هذه الصفحة.

الإعدادات

بعد تثبيت المكتبة، يجب إعداد تهيئة لها. هناك عدة طرق لتهيئة المكتبة، وهي موضحة في وثائق التهيئة.

المصادقة

بعد اختيار نوع التهيئة، يمكنك متابعة إنشاء الرموز المميزة المتبقية في OAuth2 اللازمة لإرسال الطلبات إلى واجهة برمجة التطبيقات. هناك العديد من تدفقات OAuth2 المعتمدة والموثقة في القائمة أدناه. للحصول على تفاصيل حول الاختلافات بين التدفقات والمساعدة في تحديد الأفضل لتطبيقك، راجع وثائق OAuth.

تقديم طلب واجهة برمجة التطبيقات

بعد دمج رموز OAuth2 المميزة في التهيئة، تكون جاهزًا لتقديم طلب للحصول على واجهة برمجة تطبيقات. ارجع إلى مثال الحصول على الحملات للاطلاع على طريقة بسيطة لاختبار التهيئة السليمة للمكتبة لتقديم طلبات واجهة برمجة التطبيقات.

مراجع إضافية

بعد أن تتمكن من تقديم طلب واجهة برمجة التطبيقات، تابع إلى الاستخدامات التالية لمكتبة العميل: