Βιβλιοθήκες του Lingara API
Αυτή η σελίδα έχει μεταφραστεί από τα αγγλικά. Αν οι δύο διαφέρουν, η αγγλική σελίδα είναι η σωστή. Διαβάστε την αγγλική σελίδα
Οι βιβλιοθήκες του Lingara API καλούν το ίδιο API που περιγράφει η τεκμηρίωση αναφοράς, στη γλώσσα που ήδη γράφετε. Η καθεμία παράγεται από την ίδια προδιαγραφή και τηρεί το ίδιο συμβόλαιο, οπότε ό,τι μάθετε στη μία ισχύει και στις υπόλοιπες:
- Αυθεντικοποίηση. Δίνετε στον client το client ID και το secret σας μία φορά. Εκείνος τα ανταλλάσσει με ένα access token, το αποθηκεύει στην κρυφή μνήμη, το ανανεώνει λίγο πριν λήξει και επαναλαμβάνει μια κλήση μία φορά με νέο token αν το API απαντήσει 401.
- Ροές. Οι λειτουργίες που μεταδίδουν ροή, όπως η δημιουργία λεξιλογίου, φτάνουν ως το είδος iterator που είναι φυσικό για τη γλώσσα. Η βιβλιοθήκη αναλύει τα συμβάντα και τερματίζει την επανάληψη όταν η ροή ολοκληρωθεί.
- Σφάλματα. Κάθε αποτυχία είναι ένα από τέσσερα σφάλματα με κοινό βασικό τύπο, ώστε ένας μόνο handler να τα πιάνει όλα.
- Επαναλήψεις. Ένα 429 ή 503 που δηλώνει πόση αναμονή χρειάζεται επαναλαμβάνεται αυτόματα για λογαριασμό σας, μέχρι ένα όριο. Οτιδήποτε άλλο εγείρεται αμέσως.
Κάθε δείγμα κώδικα σε αυτές τις σελίδες προέρχεται από μια δημοσιευμένη έκδοση των βιβλιοθηκών, όπου μεταγλωττίζεται και ελέγχεται πριν κυκλοφορήσει.
Εγκατάσταση
Διαλέξτε τη γλώσσα σας παρακάτω. Κάθε γλώσσα έχει τη δική της σελίδα με μια πρώτη κλήση, και οι σελίδες στην ενότητα Χρήση των βιβλιοθηκών εξηγούν κάθε συμπεριφορά πιο αναλυτικά.
TypeScript
npm install @lingara/api@0.1.0-alpha.6Rust
cargo add lingara@0.1.0-alpha.6
cargo add tokio --features macros,rt-multi-threadGo
go get github.com/Spinning-Cat-Studios/lingara_api_clients/go@v0.1.0-alpha.6Java
<dependency>
<groupId>com.getlingara</groupId>
<artifactId>lingara-java</artifactId>
<version>0.1.0-alpha.6</version>
</dependency>Kotlin
implementation("com.getlingara:lingara-kotlin:0.1.0-alpha.6")Ruby
gem install lingara -v 0.1.0-alpha.6PHP
composer require spinningcatstudios/lingara:0.1.0-alpha.6Γλώσσες
- TypeScript
Η βιβλιοθήκη του Lingara API για Node.js, δημοσιευμένη στο npm.
- Rust
Η βιβλιοθήκη του Lingara API για ασύγχρονο Rust, δημοσιευμένη στο crates.io.
- Go
Η βιβλιοθήκη του Lingara API για Go, ένα module χωρίς εξαρτήσεις εκτός της τυπικής βιβλιοθήκης.
- Java
Η βιβλιοθήκη του Lingara API για Java 17 και νεότερες, δημοσιευμένη στο Maven Central.
- Kotlin
Η βιβλιοθήκη του Lingara API για Kotlin στο JVM, χτισμένη πάνω σε coroutines.
- Ruby
Η βιβλιοθήκη του Lingara API για Ruby, ένα gem χωρίς εξαρτήσεις χρόνου εκτέλεσης.
- PHP
Η βιβλιοθήκη του Lingara API για PHP 8.2 και νεότερες, δημοσιευμένη στο Packagist.
Χρήση των βιβλιοθηκών
- Αυθεντικοποίηση
Πώς κάθε βιβλιοθήκη μετατρέπει το client ID και το secret σας σε access tokens και τα διατηρεί ενημερωμένα.
- Ροές
Πώς οι βιβλιοθήκες παραδίδουν αποτελέσματα σε ροή, και πότε μια ροή τελειώνει ή αποτυγχάνει.
- Σφάλματα και επαναλήψεις
Τα τέσσερα σφάλματα που εγείρει κάθε βιβλιοθήκη, και ποιες αποτυχίες επαναλαμβάνει για εσάς.