FastComments.com

FastComments Python SDK

Ово је званични Python SDK за FastComments.

Званични Python SDK за FastComments API

Репозиторијум

Погледајте на GitHub


Инсталација Internal Link

Instalirajte sa GitHub-a

Instalirajte direktno sa oznakom izdanja (preporučeno, potpuno reprodukovano):

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

Zakačite oznaku umjesto grane kako bi izgradnje bile determinističke. Isti oblik radi u requirements.txt:

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

Svaka označena GitHub Release takođe ima priložen prekompajlirani paket (wheel) ako više volite da instalirate binarni artefakt direktno.

Sadržaj biblioteke

Ova biblioteka sadrži dva modula: generisani API klijent i osnovnu Python biblioteku koja sadrži ručno napisane alate za olakšavanje rada sa API‑jem, uključujući SSO podršku.

Javni vs Zaštićeni API‑ji

Za API klijent postoje tri klase, DefaultApi, PublicApi i ModerationApi. DefaultApi sadrži metode koje zahtijevaju vaš API ključ, a PublicApi sadrži metode koje se mogu pozvati direktno iz preglednika/mobilnog uređaja itd. bez autentifikacije. ModerationApi pruža opsežan skup API‑ja za brzu i živu moderaciju. Svaka metoda ModerationApi prihvata sso parametar i može se autentifikovati putem SSO‑a ili FastComments.com sesijskog kolačića.

Напомене Internal Link

ID-ови за емитовање

Видјећете да треба да пошаљете broadcast_id у неким API позивима. Када примите догађаје, добићете овај ID назад, па ћете знати да игноришете догађај ако планирате оптимистички да примените промјене на клијенту (што ћете вјероватно желјети урадити јер пружа најбоље корисничко искуство). Овдје прослиједите UUID. ID би требало да буде довољно јединствен да се не појави два пута у току сесије претраживача.

Захтеви Internal Link


  • Python >= 3.8

Osnovna instalacija je čista standardna biblioteka i pruža SSO alate. Generisani API klijent (DefaultApi/PublicApi/ModerationApi) zahtijeva dodatak client, koji povlači urllib3 >= 1.25.3, python-dateutil >= 2.8.2, pydantic >= 2.0.0 i typing-extensions >= 4.0.0:

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


Trebate pomoć?

Ako naiđete na bilo kakve probleme ili imate pitanja u vezi sa Python SDK-om, molimo:

Doprinos

Doprinosi su dobrodošli! Molimo posjetite GitHub repozitorij za uputstva o doprinosu.