Início rápido

Versão da API 2026-10-affable-towhee

Cinco passos do zero a uma lista de vocabulário transmitida em fluxo: crie um cliente, coloque-o na sua shell, troque-o por um token de acesso, faça uma chamada e obtenha um novo token quando expirar.

1. Crie um cliente

Na página Integrações da aplicação web do Lingara, em app.getlingara.com/admin, em Clientes OAuth, crie um cliente com permissão para «Gerar vocabulário» (o âmbito vocab:generate). Copie o seu ID do cliente e o seu segredo. O segredo só é mostrado uma vez.

2. Coloque-o na sua shell

Guarde o ID do cliente e o segredo nas variáveis de ambiente LINGARA_CLIENT_ID e LINGARA_CLIENT_SECRET, para que nenhum segredo seja alguma vez escrito num comando.

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

3. Obtenha um token de acesso

Este comando troca o cliente por um token de acesso e guarda-o em LINGARA_TOKEN, que todos os exemplos desta referência leem. Requer jq e curl 7.76 ou posterior. Se a troca falhar, o comando mostra o código de erro (por exemplo invalid_client: verifique o ID e o segredo) e deixa LINGARA_TOKEN vazio, pelo que a chamada seguinte falha com 401 até uma troca ter êxito. Sem jq, faça a troca descrita no guia de Autenticação e copie access_token da resposta à mão.

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. Gere uma lista de vocabulário

Execute este comando. -N desativa o buffer do curl, pelo que cada evento é apresentado assim que chega.

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

O que deverá ver

Um evento started com os detalhes da lista, um evento item por palavra e depois done. As suas palavras serão diferentes das deste exemplo.

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. Quando a hora acabar

A chamada responde 401. Repita o passo 3. Se o passo 3 falhar agora, o cliente ou o seu segredo mudou na página Integrações. Um programa segue a regra do guia de Autenticação: trocar de novo uma vez por cada 401, e parar se a troca falhar.

Se uma tradução e a referência em inglês divergirem, prevalece a referência em inglês.