FastComments.com

FastComments SDK לפייתון


זה ה-SDK הרשמי של FastComments לפייתון.

ה-SDK הרשמי בפייתון עבור ממשק ה-API של FastComments

מאגר

הצג ב-GitHub


התקנה Internal Link

התקנה מ‑GitHub

התקנה ישירה מתג שחרור (מומלץ, ניתן לשחזור מלא):

pip install git+https://github.com/fastcomments/fastcomments-python.git@v3.1.0

קבעו את התג במקום סניף כדי שהבניות יהיו דטרמיניסטיות. אותה צורה עובדת ב‑requirements.txt:

fastcomments @ git+https://github.com/fastcomments/fastcomments-python.git@v3.1.0

לכל תוית GitHub Release יש גלגל מצורף אם אתם מעדיפים להתקין ארטיפקט בינארי ישירות.

תכולת הספרייה

ספרייה זו מכילה שני מודולים: לקוח ה‑API שנוצר והספרייה המרכזית של Python שמכילה כלי כתיבה ידנית שמקלים על העבודה עם ה‑API, כולל תמיכה ב‑SSO.

API ציבוריים מול מאובטחים

ללקוח ה‑API יש שלוש מחלקות, DefaultApi, PublicApi, ו‑ModerationApi. ה‑DefaultApi מכילה שיטות הדורשות מפתח API, וה‑PublicApi מכילה שיטות שניתן לקרוא להן ישירות מדפדפן/מכשיר נייד/וכו׳ ללא אימות. ה‑ModerationApi מספקת סדרה נרחבת של API מודרציה בזמן אמת ומהירה. כל שיטה ב‑ModerationApi מקבלת פרמטר sso ויכולה לאמת באמצעות SSO או קובץ cookie של session ב‑FastComments.com.

הערות Internal Link

מזהי שידור

תראה שעליך להעביר broadcast_id בחלק מבקשות ה-API. כאשר תקבל אירועים, תקבל בחזרה את המזהה הזה, כך תדע להתעלם מהאירוע אם בכוונתך להחיל שינויים באופן אופטימי בצד הלקוח (סביר שתרצה לעשות זאת שכן זה מספק את חוויית המשתמש הטובה ביותר). יש להעביר כאן UUID. המזהה צריך להיות ייחודי מספיק כדי שלא יופיע פעמיים במהלך סשן בדפדפן.

דרישות Internal Link


  • Python >= 3.8

ההתקנה הבסיסית היא pure-stdlib ומספקת את כלי ה‑SSO. ה‑API client שנוצר (DefaultApi/PublicApi/ModerationApi) דורש את התוספת client, שמורידה את urllib3 >= 1.25.3, python-dateutil >= 2.8.2, pydantic >= 2.0.0, ו‑typing-extensions >= 4.0.0:

pip install "fastcomments[client] @ git+https://github.com/fastcomments/fastcomments-python.git@v3.1.0"

זקוקים לעזרה?

אם תיתקלו בבעיות או יהיו לכם שאלות לגבי ה-Python SDK, אנא:

תרומה

תרומות מוזמנות! אנא בקרו ב-מאגר ה-GitHub לקבלת הנחיות לתרומה.