Hızlı başlangıç

API sürümü 2026-10-affable-towhee

Sıfırdan akış halinde gelen bir kelime listesine beş adım: bir istemci oluşturun, onu kabuğunuza koyun, bir erişim token'ı ile değiştirin, tek bir çağrı yapın ve süresi dolduğunda yeni bir token alın.

1. İstemci oluşturun

Lingara web uygulamasının Entegrasyonlar sayfasında, app.getlingara.com/admin adresinde, OAuth istemcileri altında, Kelime üret iznine sahip bir istemci oluşturun (vocab:generate kapsamı). İstemci kimliğini ve gizli anahtarını kopyalayın. Gizli anahtar yalnızca bir kez gösterilir.

2. Kabuğunuza koyun

İstemci kimliğini ve gizli anahtarı LINGARA_CLIENT_ID ve LINGARA_CLIENT_SECRET ortam değişkenlerinde saklayın, böylece hiçbir gizli anahtar bir komuta yazılmaz.

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

3. Erişim token'ı alın

Bu komut istemciyi bir erişim token'ı ile değiştirir ve onu, bu referanstaki her örneğin okuduğu LINGARA_TOKEN içinde tutar. jq ve curl 7.76 ya da daha yenisini gerektirir. Değişim başarısız olursa komut hata kodunu yazdırır (örneğin invalid_client: kimliği ve gizli anahtarı kontrol edin) ve LINGARA_TOKEN değişkenini boş bırakır; böylece bir değişim başarılı olana kadar sonraki çağrı 401 ile başarısız olur. jq yoksa, değişimi Kimlik doğrulama kılavuzundaki gibi çalıştırın ve yanıttaki access_token değerini elle kopyalayın.

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. Kelime listesi oluşturun

Bu komutu çalıştırın. -N curl'ün arabelleğe almasını kapatır, böylece her olay geldiği anda yazdırılır.

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

Ne görmelisiniz

Listenin ayrıntılarını içeren bir started olayı, her kelime için bir item olayı, ardından done. Sizin kelimeleriniz bu örnektekilerden farklı olacaktır.

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. Bir saat dolduğunda

Çağrı 401 yanıtı verir. 3. adımı yeniden çalıştırın. 3. adım artık başarısız oluyorsa, istemci ya da gizli anahtarı Entegrasyonlar sayfasında değişmiştir. Bir program Kimlik doğrulama kılavuzunun kuralını izler: her 401 için bir kez yeniden değiştirin ve değişim başarısız olursa durun.

Bir çeviri ile İngilizce referans arasında fark varsa, İngilizce referans geçerlidir.