FastComments.com

FastComments SDK לפייתון


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

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

מאגר

הצג ב-GitHub


התקנה Internal Link

התקנה מ‑GitHub

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

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

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

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

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

תוכן הספרייה

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

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

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

הערות Internal Link

מזהי שידור

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

דרישות Internal Link


  • Python >= 3.8

ההתקנה הבסיסית היא pure-stdlib ומספקת את כלי ה‑SSO. לקוח ה‑API שנוצר (DefaultApi/PublicApi/ModerationApi) דורש את ה‑extra 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.0.0"

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

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

תרומה

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