FastComments.com

FastComments Python SDK


To je uradni Python SDK za FastComments.

Uradni Python SDK za FastComments API

Repozitorij

Ogled na GitHubu


Namestitev Internal Link

Namestitev iz GitHub-a

Namestite neposredno iz oznake izdaj (priporočeno, popolnoma reproducibilno):

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

Označite oznako namesto veje, da so gradnje deterministične. Enaka oblika deluje v requirements.txt:

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

Vsaka označena GitHub Release ima tudi priložen sestavljen paket (wheel), če raje neposredno namestite binarni artefakt.

Vsebina knjižnice

Ta knjižnica vsebuje dva modula: ustvarjenega API odjemalca in jedrno Python knjižnico, ki vsebuje ročno napisane pripomočke za olajšanje dela z API-jem, vključno s podporo SSO.

Javni vs Zavarovani API-ji

Za API odjemalca obstajajo trije razredi, DefaultApi, PublicApi in ModerationApi. DefaultApi vsebuje metode, ki zahtevajo vaš API ključ, PublicApi pa vsebuje metode, ki jih je mogoče klicati neposredno iz brskalnika/mobilne naprave naprave/itd. brez avtentikacije. ModerationApi ponuja obsežen nabor živih in hitrih moderacijskih API-jev. Vsaka metoda ModerationApi sprejme parameter sso in se lahko avtenticira prek SSO ali piškotka seje FastComments.com.

Opombe Internal Link

ID-ji za broadcast

V nekaterih API klicih boste opazili, da morate posredovati broadcast_id. Ko prejmete dogodke, boste to ID dobili nazaj, tako da boste vedeli, da morate dogodek ignorirati, če nameravate optimistično uporabiti spremembe na odjemalcu (kar boste verjetno želeli storiti, saj zagotavlja najboljšo izkušnjo). Tukaj posredujte UUID. ID naj bo dovolj enoličen, da se v isti seji brskalnika ne pojavi dvakrat.

Zahteve Internal Link


  • Python >= 3.8

Osnovna namestitev je čista standardna knjižnica in zagotavlja SSO pripomočke. Generiran API odjemalec (DefaultApi/PublicApi/ModerationApi) potrebuje dodatno komponento client, ki prinese urllib3 >= 1.25.3, python-dateutil >= 2.8.2, pydantic >= 2.0.0, in typing-extensions >= 4.0.0:

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

Potrebujete pomoč?

Če naletite na težave ali imate vprašanja glede Python SDK, prosimo:

Prispevanje

Prispevki so dobrodošli! Obiščite repozitorij na GitHubu za smernice glede prispevkov.