FastComments.com

FastComments Python SDK


Це офіційний Python SDK для FastComments.

Офіційний Python SDK для API FastComments

Репозиторій

Переглянути на GitHub


AI coding agents Internal Link

skills.sh

Надайте вашому агенту коду контекст FastComments, який йому потрібен — віджети, конфігурація, Secure SSO, REST API та SDK:

npx skills add fastcomments/skills

Працює з Claude Code, Codex, Cursor, Copilot, Gemini та будь‑яким іншим агентом, який підтримує skills CLI.

Installation Internal Link

Встановити з GitHub

Встановити безпосередньо з тегу релізу (рекомендовано, повністю відтворювано):

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

Закріпіть тег замість гілки, щоб збірки були детермінованими. Така ж форма працює у requirements.txt:

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

Кожен тегований GitHub Release також має прикріплене зібране wheel, якщо ви віддаєте перевагу встановленню бінарного артефакту безпосередньо.

Вміст бібліотеки

Ця бібліотека містить два модулі: згенерований клієнт API та основну бібліотеку Python, яка містить написані вручну утиліти, що спрощують роботу з API, включаючи підтримку SSO.

Публічні та захищені API

Для клієнта API існує три класи, DefaultApi, PublicApi та ModerationApi. DefaultApi містить методи, які вимагають ваш API‑ключ, а PublicApi містить методи, які можна викликати безпосередньо з браузера/мобільного пристрою тощо без автентифікації. ModerationApi надає широкий набір живих та швидких API модерації. Кожен метод ModerationApi приймає параметр sso і може автентифікуватися через SSO або cookie сесії FastComments.com.

Notes Internal Link

Ідентифікатори трансляцій

Ви побачите, що в деяких викликах API потрібно передавати broadcast_id. Коли ви отримуватимете події, ви отримаєте цей ідентифікатор назад, тож знатимете, що слід ігнорувати подію, якщо ви плануєте оптимістично застосовувати зміни на клієнті (а ймовірно саме так ви й захочете зробити, оскільки це забезпечує найкращий досвід). Передавайте сюди UUID. Ідентифікатор має бути достатньо унікальним, щоб не з'явитися двічі в одній сесії браузера.

Requirements Internal Link


  • Python >= 3.8

Базова установка є чистою стандартною бібліотекою і надає утиліти SSO. Згенерований API‑клієнт (DefaultApi/PublicApi/ModerationApi) потребує додаткового client, який підтягує urllib3 >= 1.25.3, python-dateutil >= 2.8.2, pydantic >= 2.0.0, та typing-extensions >= 4.0.0:

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

Потрібна допомога?

Якщо ви зіткнулися з будь-якими проблемами або маєте питання щодо Python SDK, будь ласка:

Участь

Внески вітаються! Будь ласка, відвідайте репозиторій GitHub для отримання вказівок щодо внесків.