Inicio rápido

Versión de la API 2026-10-affable-towhee

Cinco pasos para pasar de nada a una lista de vocabulario transmitida en flujo: crea un cliente, ponlo en tu shell, intercámbialo por un token de acceso, haz una llamada y obtén un token nuevo cuando caduque.

1. Crea un cliente

En la página Integraciones de la aplicación web de Lingara, en app.getlingara.com/admin, en Clientes OAuth, crea un cliente que pueda «Generar vocabulario» (el ámbito vocab:generate). Copia su ID de cliente y su secreto. El secreto solo se muestra una vez.

2. Ponlo en tu shell

Guarda el ID de cliente y el secreto en las variables de entorno LINGARA_CLIENT_ID y LINGARA_CLIENT_SECRET, para que nunca se escriba un secreto en un comando.

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

3. Obtén un token de acceso

Este comando intercambia el cliente por un token de acceso y lo guarda en LINGARA_TOKEN, que leen todos los ejemplos de esta referencia. Necesita jq y curl 7.76 o posterior. Si el intercambio falla, el comando muestra el código de error (por ejemplo invalid_client: revisa el ID y el secreto) y deja LINGARA_TOKEN vacío, así que la siguiente llamada falla con 401 hasta que un intercambio tenga éxito. Sin jq, haz el intercambio de la guía de Autenticación y copia access_token de la respuesta a mano.

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. Genera una lista de vocabulario

Ejecuta este comando. -N desactiva el búfer de curl, así que cada evento se imprime en cuanto llega.

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

Qué deberías ver

Un evento started con los detalles de la lista, un evento item por palabra y luego done. Tus palabras serán distintas de las de este ejemplo.

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. Cuando pase la hora

La llamada responde 401. Vuelve a ejecutar el paso 3. Si ahora falla el paso 3, el cliente o su secreto ha cambiado en la página Integraciones. Un programa sigue la regla de la guía de Autenticación: volver a intercambiar una vez por cada 401, y detenerse si el intercambio falla.

Si una traducción y la referencia en inglés difieren, prevalece la referencia en inglés.