FastComments.com

SDK Python de FastComments

Ceci est le SDK Python officiel pour FastComments.

SDK Python officiel pour l'API FastComments

Dépôt

Voir sur GitHub


Installation Internal Link

Installer depuis GitHub

Installez directement à partir d’une balise de version (recommandé, entièrement reproductible) :

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

Épinglez la balise plutôt qu’une branche afin que les builds soient déterministes. La même forme fonctionne dans requirements.txt :

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

Chaque GitHub Release balisée possède également une roue pré‑construite jointe si vous préférez installer un artefact binaire directement.

Contenu de la bibliothèque

Cette bibliothèque contient deux modules : le client API généré et la bibliothèque centrale Python qui comprend des utilitaires écrits à la main pour faciliter l’utilisation de l’API, y compris la prise en charge du SSO.

API publiques vs sécurisées

Pour le client API, il existe trois classes, DefaultApi, PublicApi et ModerationApi. La classe DefaultApi contient des méthodes qui requièrent votre clé API, et PublicApi contient des méthodes pouvant être appelées directement depuis un navigateur, un appareil mobile, etc., sans authentification. La classe ModerationApi fournit une suite étendue d’API de modération en direct et rapides. Chaque méthode ModerationApi accepte un paramètre sso et peut s’authentifier via SSO ou un cookie de session FastComments.com.

Notes Internal Link

Identifiants de diffusion

Vous verrez que vous devez transmettre un broadcast_id dans certaines requêtes d'API. Lorsque vous recevez des événements, vous récupérerez cet ID, ce qui vous permet de l'ignorer si vous prévoyez d'appliquer de façon optimiste des modifications côté client (ce que vous voudrez probablement faire puisque cela offre la meilleure expérience). Passez un UUID ici. L'ID doit être suffisamment unique pour ne pas apparaître deux fois dans une session du navigateur.

Prérequis Internal Link


  • Python >= 3.8

L'installation de base est pure-stdlib et fournit les utilitaires SSO. Le client API généré (DefaultApi/PublicApi/ModerationApi) nécessite l'extra client, qui apporte urllib3 >= 1.25.3, python-dateutil >= 2.8.2, pydantic >= 2.0.0 et typing-extensions >= 4.0.0 :

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

Besoin d'aide ?

Si vous rencontrez des problèmes ou avez des questions au sujet du SDK Python, veuillez :

Contribuer

Les contributions sont les bienvenues ! Veuillez consulter le référentiel GitHub pour les directives de contribution.