Démarrage rapide

Version de l'API 2026-10-affable-towhee

Cinq étapes pour passer de rien à une liste de vocabulaire diffusée en flux : créer un client, le placer dans votre shell, l'échanger contre un jeton d'accès, effectuer un appel, et obtenir un nouveau jeton lorsqu'il expire.

1. Créer un client

Sur la page Intégrations de l'application web Lingara, à l'adresse app.getlingara.com/admin, sous « Clients OAuth », créez un client autorisé à « Générer du vocabulaire » (la portée vocab:generate). Copiez son identifiant du client et son secret. Le secret n'est affiché qu'une seule fois.

2. Le placer dans votre shell

Stockez l'identifiant du client et le secret dans les variables d'environnement LINGARA_CLIENT_ID et LINGARA_CLIENT_SECRET, afin qu'aucun secret ne soit jamais écrit dans une commande.

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

3. Obtenir un jeton d'accès

Cette commande échange le client contre un jeton d'accès et le conserve dans LINGARA_TOKEN, que lit chaque exemple de cette référence. Elle nécessite jq et curl 7.76 ou ultérieur. Si l'échange échoue, la commande affiche le code d'erreur (par exemple invalid_client : vérifiez l'identifiant et le secret) et laisse LINGARA_TOKEN vide, si bien que l'appel suivant échoue avec 401 jusqu'à ce qu'un échange réussisse. Sans jq, effectuez l'échange décrit dans le guide Authentification et copiez à la main access_token depuis la réponse.

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. Générer une liste de vocabulaire

Exécutez cette commande. -N désactive la mise en mémoire tampon de curl, si bien que chaque événement s'affiche dès son arrivée.

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}'

Ce que vous devriez voir

Un événement started avec les détails de la liste, un événement item par mot, puis done. Vos mots différeront de cet exemple.

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. Quand l'heure est écoulée

L'appel répond 401. Refaites l'étape 3. Si l'étape 3 échoue désormais, le client ou son secret a changé sur la page Intégrations. Un programme suit la règle du guide Authentification : échanger de nouveau une fois par 401, et s'arrêter si l'échange échoue.

En cas de divergence entre une traduction et la référence en anglais, la référence en anglais fait foi.