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

Direkt von einem Release-Tag installieren (empfohlen, vollständig reproduzierbar):

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

Den Tag anstelle eines Branches festlegen, damit Builds deterministisch sind. Die gleiche Form funktioniert in requirements.txt:

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

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

Bibliotheksinhalt

Diese Bibliothek enthält zwei Module: den generierten API-API‑Client und die Kern‑Python‑Bibliothek, die handgeschriebene Hilfsprogramme enthält, um die Arbeit mit der API zu erleichtern, 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 benötigen, und die PublicApi enthält Methoden, die direkt von einem Browser/Mobilgerät/etc. ohne Authentifizierung aufgerufen werden können. Die ModerationApi bietet eine umfangreiche Suite 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 Basisinstallation ist pure-stdlib und stellt die SSO‑Dienstprogramme bereit. 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.1.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.