Γρήγορη εκκίνηση

Έκδοση API 2026-10-affable-towhee

Πέντε βήματα από το μηδέν σε μια λίστα λεξιλογίου σε ροή: δημιουργήστε έναν πελάτη, βάλτε τον στο κέλυφός σας, ανταλλάξτε τον με ένα διακριτικό πρόσβασης, κάντε μία κλήση και αποκτήστε νέο διακριτικό όταν λήξει.

1. Δημιουργήστε έναν πελάτη

Στη σελίδα Ενσωματώσεις της εφαρμογής web του Lingara, στη διεύθυνση app.getlingara.com/admin, στην ενότητα Πελάτες OAuth, δημιουργήστε έναν πελάτη με την άδεια «Δημιουργία λεξιλογίου» (το εύρος δικαιωμάτων vocab:generate). Αντιγράψτε το αναγνωριστικό πελάτη και το μυστικό του. Το μυστικό εμφανίζεται μόνο μία φορά.

2. Βάλτε τον στο κέλυφός σας

Αποθηκεύστε το αναγνωριστικό πελάτη και το μυστικό στις μεταβλητές περιβάλλοντος LINGARA_CLIENT_ID και LINGARA_CLIENT_SECRET, ώστε κανένα μυστικό να μη γράφεται ποτέ μέσα σε εντολή.

export LINGARA_CLIENT_ID="<your client id>"
export LINGARA_CLIENT_SECRET="<your client secret>"

3. Αποκτήστε ένα διακριτικό πρόσβασης

Αυτή η εντολή ανταλλάσσει τον πελάτη με ένα διακριτικό πρόσβασης και το κρατά στο LINGARA_TOKEN, από όπου το διαβάζει κάθε παράδειγμα σε αυτή την αναφορά. Χρειάζεται το jq και curl 7.76 ή νεότερο. Αν η ανταλλαγή αποτύχει, η εντολή εμφανίζει τον κωδικό σφάλματος (για παράδειγμα invalid_client: ελέγξτε το αναγνωριστικό και το μυστικό) και αφήνει το LINGARA_TOKEN κενό, οπότε η επόμενη κλήση αποτυγχάνει με 401 μέχρι να πετύχει μια ανταλλαγή. Χωρίς jq, εκτελέστε την ανταλλαγή από τον οδηγό Έλεγχος ταυτότητας και αντιγράψτε με το χέρι το access_token από την απάντηση.

export LINGARA_TOKEN="$(curl -sS --fail-with-body -X POST "https://api.getlingara.com/oauth/token" \
  -u "$LINGARA_CLIENT_ID:$LINGARA_CLIENT_SECRET" \
  -d "grant_type=client_credentials" \
  --data-urlencode "scope=vocab:generate" | jq -r '.access_token // error(.error)')"

4. Δημιουργήστε μια λίστα λεξιλογίου

Εκτελέστε αυτή την εντολή. Το -N απενεργοποιεί την προσωρινή αποθήκευση του curl, ώστε κάθε συμβάν να εμφανίζεται μόλις φτάσει.

curl -N -X POST "https://api.getlingara.com/v1/vocab/stream" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"level":2,"source_lang":"en","target_lang":"zh","count":8}'

Τι πρέπει να δείτε

Ένα συμβάν started με τα στοιχεία της λίστας, ένα συμβάν item ανά λέξη και έπειτα done. Οι λέξεις σας θα διαφέρουν από αυτό το παράδειγμα.

event: started
data: {"meta":{"level":2,"source_lang":"en","target_lang":"zh","framework":"HSK","count":2,"ai_generated":true}}

event: item
data: {"word":"你好","pronunciation":"nǐ hǎo","translation":"hello","example":{"sentence":"你好，我叫小明。","translation":"Hello, my name is Xiaoming."}}

event: item
data: {"word":"谢谢","pronunciation":"xiè xie","translation":"thank you"}

event: done
data: {}

5. Όταν περάσει η ώρα

Η κλήση απαντά 401. Εκτελέστε ξανά το βήμα 3. Αν το βήμα 3 αποτυγχάνει πλέον, ο πελάτης ή το μυστικό του έχει αλλάξει στη σελίδα Ενσωματώσεις. Ένα πρόγραμμα ακολουθεί τον κανόνα του οδηγού Έλεγχος ταυτότητας: ανταλλάσσει ξανά μία φορά ανά 401 και σταματά αν η ανταλλαγή αποτύχει.

Αν μια μετάφραση διαφέρει από την αγγλική τεκμηρίωση, ισχύει η αγγλική τεκμηρίωση.