الحصول على مفتاح جلسة pyLast 5.5 عبر وسيط

يستطيع pyLast إرسال طلبات مصادقة أثناء إنشاء كائن network إذا قُدّمت معلومات تسجيل دخول كافية. ولضبط المسار أولاً، أنشئ network دون إطلاق مسار المصادقة هذا.

يستخدم المثال التالي واجهة عنوان الوسيط في pyLast 5.5 ومساعد المصادقة العامة على الويب:

import pylast

network = pylast.LastFMNetwork(api_key=api_key, api_secret=api_secret)
network.enable_proxy('http://proxy.example.net:8080')

generator = pylast.SessionKeyGenerator(network)
authorization_url = generator.get_web_auth_url()

يقدّم التطبيق مفتاح API والسر الخاص به. ولمسار Last.fm API عام يسمح بوسطاء غير موثّقين، استخدم نقطة نهاية من قائمة وسطاء HTTP داخل enable_proxy؛ فهذه النقاط لا تقدّم بيانات اعتماد المزوّد. ويجلب الاستدعاء الأخير رمز المصادقة عبر كائن network المهيّأ. اطلب من المستخدم فتح العنوان الناتج وتفويض التطبيق.

بعد التفويض، استخدم المولّد نفسه للحصول على مفتاح الجلسة:

network.session_key = generator.get_web_auth_session_key(authorization_url)

يحتفظ المولّد بالرمز المرتبط بذلك العنوان. والإبقاء على network والمولّد نفسيهما بين هاتين الخطوتين يحفظ المسار المهيّأ وحالة المصادقة المعلّقة.

عندما يوجد مفتاح بالفعل

إذا كان مفتاح الجلسة محفوظاً بالفعل، فمرّره بوصفه session_key عند إنشاء network، ثم فعّل الوسيط قبل أول استدعاء لـ API. ولا يحتاج المنشئ إلى طلب مفتاح آخر. ويمكن لعمليات البحث للقراءة فقط استخدام network المهيّأ دون بدء مسار التفويض هذا.