شروع سریع

نسخهٔ API 2026-10-affable-towhee

پنج گام از صفر تا یک فهرست واژگان جریانی: کلاینتی بسازید، آن را در پوستهٔ خود قرار دهید، آن را با یک توکن دسترسی مبادله کنید، یک فراخوانی انجام دهید و وقتی توکن منقضی شد توکن تازه‌ای بگیرید.

1. ساخت کلاینت

در صفحهٔ یکپارچه‌سازی‌ها در نسخهٔ وب 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 یک بار دوباره مبادله کنید و اگر مبادله شکست خورد متوقف شوید.

اگر ترجمه با مرجع انگلیسی تفاوت داشته باشد، مرجع انگلیسی معتبر است.