FastComments.com

FastComments Python SDK


Dit is de officiële Python SDK voor FastComments.

Officiële Python SDK voor de FastComments API

Repository

Bekijk op GitHub


Installatie Internal Link

Installeren vanaf GitHub

Installeer direct vanaf een release-tag (aanbevolen, volledig reproduceerbaar):

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

Pin de tag in plaats van een branch zodat builds deterministisch zijn. Hetzelfde formaat werkt in requirements.txt:

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

Elke gelabelde GitHub Release heeft ook een gebouwd wheel bijgevoegd als je de voorkeur geeft aan het rechtstreeks installeren van een binair artefact.

Bibliotheekinhoud

Deze bibliotheek bevat twee modules: de gegenereerde API-client en de kern‑Python‑bibliotheek die handgeschreven hulpprogramma's bevat om het werken met de API gemakkelijker te maken, inclusief SSO‑ondersteuning.

Publieke versus beveiligde API's

Voor de API-client zijn er drie klassen, DefaultApi, PublicApi en ModerationApi. De DefaultApi bevat methoden die je API‑sleutel vereisen, en de PublicApi bevat methoden die rechtstreeks vanuit een browser/mobiel apparaat/etc. kunnen worden aangeroepen zonder authenticatie. De ModerationApi biedt een uitgebreide reeks live‑ en snelle moderatie‑API's. Elke ModerationApi‑methode accepteert een sso‑parameter en kan authenticeren via SSO of een FastComments.com‑sessiecookie.

Opmerkingen Internal Link

Broadcast-ID's

Je zult zien dat je een broadcast_id moet doorgeven in sommige API-aanroepen. Wanneer je gebeurtenissen ontvangt, krijg je deze ID terug, zodat je de gebeurtenis kunt negeren als je van plan bent wijzigingen optimistisch op de client toe te passen (wat je waarschijnlijk wilt doen omdat het de beste ervaring biedt). Geef hier een UUID door. De ID moet uniek genoeg zijn om niet twee keer voor te komen in een browsersessie.

Vereisten Internal Link


  • Python >= 3.8

De basisinstallatie is pure-stdlib en levert de SSO‑hulpmiddelen. De gegenereerde API‑client (DefaultApi/PublicApi/ModerationApi) heeft de extra client nodig, die urllib3 >= 1.25.3, python-dateutil >= 2.8.2, pydantic >= 2.0.0 en typing-extensions >= 4.0.0 binnenhaalt:

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

Hulp nodig?

Als u problemen ondervindt of vragen heeft over de Python SDK, kunt u:

Bijdragen

Bijdragen zijn welkom! Bezoek de GitHub-repository voor richtlijnen voor bijdragen.