FastComments.com

FastComments SDK για Python


Αυτό είναι το επίσημο Python SDK για το FastComments.

Επίσημο Python SDK για το API του FastComments

Αποθετήριο

Προβολή στο GitHub


Εγκατάσταση Internal Link

Εγκατάσταση από το GitHub

Εγκαταστήστε απευθείας από ετικέτα έκδοσης (συνιστάται, πλήρως αναπαραγώγιμο):

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

Σημειώστε την ετικέτα αντί για ένα κλάδο ώστε οι κατασκευές να είναι ντετερμινιστικές. Η ίδια μορφή λειτουργεί στο requirements.txt:

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

Κάθε ετικετομένη GitHub Release διαθέτει επίσης ένα προδημιουργημένο wheel συνημμένο εάν προτιμάτε να εγκαταστήσετε ένα δυαδικό artefact απευθείας.

Περιεχόμενα Βιβλιοθήκης

Αυτή η βιβλιοθήκη περιλαμβάνει δύο modules: τον παραγόμενο πελάτη API και τη βασική βιβλιοθήκη Python που περιέχει χειρογραφούμενα βοηθητικά εργαλεία για να διευκολύνουν τη δουλειά με το API, συμπεριλαμβανομένης της υποστήριξης SSO.

Δημόσια vs Ασφαλισμένα APIs

Για τον πελάτη API, υπάρχουν τρεις κλάσεις, DefaultApi, PublicApi και ModerationApi. Η DefaultApi περιέχει μεθόδους που απαιτούν το κλειδί API σας, και η PublicApi περιέχει μεθόδους που μπορούν να κληθούν απευθείας από έναν περιηγητή/συσκευή κινητής/κτλ χωρίς έλεγχο ταυτότητας. Η ModerationApi προσφέρει μια εκτενή σειρά ζωντανών και γρήγορων APIs moderation. Κάθε μέθοδος της ModerationApi δέχεται μια παράμετρο sso και μπορεί να πιστοποιηθεί μέσω SSO ή μέσω cookie συνεδρίας FastComments.com.

Σημειώσεις Internal Link

Αναγνωριστικά Broadcast

Θα δείτε ότι πρέπει να περάσετε ένα broadcast_id σε κάποιες κλήσεις API. Όταν λαμβάνετε συμβάντα, θα λάβετε αυτό το ID πίσω, ώστε να ξέρετε να αγνοήσετε το συμβάν αν σκοπεύετε να εφαρμόσετε τις αλλαγές οπτιμιστικά στην πλευρά του πελάτη (κάτι που πιθανότατα θα θέλετε να κάνετε καθώς προσφέρει την καλύτερη εμπειρία). Περάστε ένα UUID εδώ. Το ID θα πρέπει να είναι αρκετά μοναδικό ώστε να μην εμφανιστεί δύο φορές σε μια συνεδρία του προγράμματος περιήγησης.

Απαιτήσεις Internal Link

  • Python >= 3.8

Η βασική εγκατάσταση είναι pure-stdlib και παρέχει τις βοηθητικές λειτουργίες SSO. Ο παραγόμενος API client (DefaultApi/PublicApi/ModerationApi) χρειάζεται το client extra, που φέρνει το 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.0.0"

Χρειάζεστε βοήθεια;

Εάν αντιμετωπίσετε προβλήματα ή έχετε ερωτήσεις σχετικά με το Python SDK, παρακαλούμε:

Συνεισφορές

Οι συνεισφορές είναι ευπρόσδεκτες! Παρακαλούμε επισκεφθείτε το αποθετήριο GitHub για οδηγίες σχετικά με τις συνεισφορές.