Mon Feb 16 2026

...

Δημοσιεύτηκαν Γεννημένες Τύπου-Ασφαλείς SDK Πελάτη

! Αυτό το Άρθρο Περιέχει Τεχνική Ορολογία

Τι Νέο

Στην ανάρτησή μας για τη μετάβαση σε TypeScript, αναφέραμε ότι θα έρχονταν γεννημένες SDK πελάτη. Έφτασαν.

Η FastComments τώρα προσφέρει επίσημες, τύπου-ασφαλείς SDK για δέκα γλώσσες:

• TypeScript / JavaScript (npm)
• Python (PyPI)
• Rust (crates.io)
• Go (Go modules)
• Java (Maven)
• PHP (Composer)
• Ruby (RubyGems)
• Swift (Swift Package Manager)
• C++ (CMake)
• Nim (Nimble)

Κάθε SDK είναι γεννημένη από την ίδια προδιαγραφή OpenAPI που παράγει ο διακομιστής μας. Οι τύποι, οι υπογραφές μεθόδων και τα μοντέλα αιτήσεων/απαντήσεων παραμένουν συγχρονισμένα με το πραγματικό API αυτόματα. Ο μεταγλωττιστής σας εντοπίζει τυπογραφικά λάθη στα ονόματα πεδίων και ελλείπουσες παραμέτρους πριν η κωδικοποίησή σας πραγματοποιήσει οποιοδήποτε έγγραφο δικτύου.

Πώς Λειτουργεί

Η μετάβαση σε TypeScript ήταν προϋπόθεση για αυτό. Τώρα που ο κωδικός του διακομιστή μας είναι πλήρως τυποποιημένος, χρησιμοποιούμε την παραλλαγή μας του TSOA για να δημιουργήσουμε μια προδιαγραφή OpenAPI 3.0 απευθείας από τους ελεγκτές διαδρομής μας. Αυτή η προδιαγραφή τροφοδοτεί το OpenAPI Generator για να παραγάγει βιβλιοθήκες πελάτη για κάθε γλώσσα.

Όταν το API αλλάζει, τα εργαλεία μας εντοπίζουν την διαφορά στην προδιαγραφή, ξαναδημιουργούν τις επηρεασμένες SDK, τρέχουν δοκιμές για κάθε γλώσσα και ανοίγουν αυτόματα pull requests. Δημιουργήσαμε ένα μικρό εργαλείο διαχείρισης σε Nim που συντονίζει τον κύκλο αναβάθμισης-δοκιμής-απελευθέρωσης σε όλες τις δέκα αποθήκες.

Τι Περιέχει Κάθε SDK

Κάθε SDK παρέχει δύο κλάσεις API:

• DefaultApi: επιβεβαιωμένα endpoints που απαιτούν το κλειδί API σας. Χρησιμοποιήστε τα αυτά από την πλευρά του διακομιστή για μετριασμό, διαχείριση χρηστών, αναλύσεις και μαζικές λειτουργίες.
• PublicApi: μη επιβεβαιωμένα endpoints ασφαλή για κλήση από προγράμματα περιήγησης και κινητές εφαρμογές. Αυτά καλύπτουν την ανάκτηση σχολίων, την ανάρτηση, την ψηφοφορία και άλλες λειτουργίες που αφορούν τον πελάτη.

Όλες οι SDK περιλαμβάνουν επίσης βοηθητικά εργαλεία SSO για ενσωμάτωση με το υπάρχον σύστημα αυθεντικοποίησής σας. Η SDK TypeScript παρέχει επιπλέον συνδρομές σε πραγματικό χρόνο για ζωντανά σχόλια.

Τεκμηρίωση

Πλήρης τεκμηρίωση API είναι διαθέσιμη στο docs.fastcomments.com. Κάθε αποθήκη SDK περιλαμβάνει επίσης παραγόμενα έγγραφα που καλύπτουν κάθε διαθέσιμη μέθοδο και μοντέλο.

Για ενσωμάτωση SSO, δείτε τον οδηγό SSO. Όλες οι δέκα SDK περιλαμβάνουν βοηθούς SSO χρησιμοποιώντας τις εγγενείς βιβλιοθήκες κρυπτογράφησης τους.

Συμπερασματικά

Η ύπαρξη ενός πλήρως τυποποιημένου διακομιστή έκανε την παραγωγή μιας αξιόπιστης προδιαγραφής OpenAPI απλή υπόθεση, και από εκεί, η παραγωγή πελατών για δέκα (και κάποια μέρα περισσότερες!) γλώσσες ήταν κυρίως θέμα οικοδόμησης αυτοματισμού και βελτίωσης των ορισμών τύπων μας ώστε να είναι καταναλώσιμοι, χωρίς να προσθέτουμε πάρα πολύ αφαίρεση που θα καθυστερούσε το FastComments!

Όπως σε όλες τις μεγάλες εκδόσεις, είμαστε ευχαριστημένοι που μπορέσαμε να αφιερώσουμε χρόνο για να βελτιώσουμε, να δοκιμάσουμε και να απελευθερώσουμε σωστά αυτές τις SDK. Ενημερώστε μας παρακάτω αν έχετε οποιαδήποτε ανατροφοδότηση ή αν υπάρχει κάποια γλώσσα που θα θέλατε να προσθέσουμε.

Υγειά!