FastComments.com

FastComments Python SDK


Dies ist das offizielle Python-SDK für FastComments.

Offizielles Python-SDK für die FastComments-API

Repository

Auf GitHub ansehen


Installation Internal Link

Installation von GitHub

Installieren Sie direkt von einem Release‑Tag (empfohlen, vollständig reproduzierbar):

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

Pinnen Sie das Tag anstatt eines Branches, damit Builds deterministisch sind. Die gleiche Form funktioniert in requirements.txt:

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

Jeder getaggte GitHub Release enthält ebenfalls ein gebautes Wheel, falls Sie ein binäres Artefakt direkt installieren möchten.

Bibliotheksinhalt

Diese Bibliothek enthält zwei Module: den generierten API‑Client und die Kern‑Python‑Bibliothek, die handgeschriebene Hilfsprogramme enthält, um die Arbeit mit der API zu vereinfachen, einschließlich SSO‑Unterstützung.

Öffentliche vs gesicherte APIs

Für den API‑Client gibt es drei Klassen: DefaultApi, PublicApi und ModerationApi. Die DefaultApi enthält Methoden, die Ihren API‑Schlüssel erfordern, und PublicApi enthält Methoden, die direkt von einem Browser/Mobilgerät usw. ohne Authentifizierung aufgerufen werden können. Die ModerationApi bietet eine umfangreiche Palette von Live‑ und schnellen Moderations‑APIs. Jede ModerationApi‑Methode akzeptiert einen sso‑Parameter und kann sich über SSO oder ein FastComments.com‑Session‑Cookie authentifizieren.

Hinweise Internal Link

Broadcast-IDs

Sie werden feststellen, dass Sie in einigen API-Aufrufen ein broadcast_id übergeben sollen. Wenn Sie Ereignisse erhalten, bekommen Sie diese ID zurück, sodass Sie das Ereignis ignorieren können, falls Sie Änderungen auf dem Client optimistisch anwenden möchten (was Sie wahrscheinlich tun sollten, da es die beste Nutzererfahrung bietet). Übergeben Sie hier eine UUID. Die ID sollte so einzigartig sein, dass sie in einer Browsersitzung nicht zweimal vorkommt.

Voraussetzungen Internal Link


  • Python >= 3.8

Die Basissinstallation ist pure-stdlib und liefert die SSO‑Dienstprogramme. Der generierte API-Client (DefaultApi/PublicApi/ModerationApi) benötigt das client‑Extra, das urllib3 >= 1.25.3, python-dateutil >= 2.8.2, pydantic >= 2.0.0 und typing-extensions >= 4.0.0 einbindet:

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

Benötigen Sie Hilfe?

Wenn Sie auf Probleme stoßen oder Fragen zum Python SDK haben, bitte:

Mitwirken

Beiträge sind willkommen! Bitte besuchen Sie das GitHub-Repository für Richtlinien zur Mitarbeit.