Lingara Lingara Belgeler Rehberler API Kütüphaneler Uygulamalar Oluştur Web uygulaması
Dil: Türkçe

Ders planını getir

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

get https://api.getlingara.com/v1/lesson-plans/{id}

Size ait bir ders planını döndürür. Hâlâ oluşturulmakta olan bir planın henüz content alanı yoktur.

Kapsamlar lesson_plans:read

Parametreler

Lingara-Versionheaderstringisteğe bağlı
Bu isteğin yanıtlanacağı API sürümü. Belirtilmezse bir erişim token'ı istemcisinin bağlı olduğu sürümü, token içermeyen bir istek ise güncel sürümü alır. Hâlâ geliştirilmekte olan sürüme yalnızca burada adı verilerek ulaşılır. Bilinmeyen bir sürüm 400 ve api_version_unknown koduyla yanıtlanır. GET /v1/versions sürümleri listeler.
idpathstringzorunlu

Yanıtlar

200 Ders planı

idstringzorunlu
statusPlanStatuszorunlu
titlestring | nullisteğe bağlı
source_langstringzorunlu
target_langstringzorunlu
levelintegerzorunlu
created_atstringzorunlu
completed_atstring | nullisteğe bağlı
ai_generatedbooleanzorunlu
contentLessonPlanContent | nullisteğe bağlı
introductionstring | nullisteğe bağlı
learning_objectivesarray of stringzorunlu
vocabularyarray of PlanWordzorunlu
wordstringzorunlu
pronunciationstring | nullisteğe bağlı
translationstringzorunlu
setsarray of PlanSetzorunlu
numberintegerzorunlu
contextstring | nullisteğe bağlı
questionsarray of PlanQuestionzorunlu
typestringzorunlu
promptstringzorunlu
optionsarray of string | nullisteğe bağlı
answerstringzorunlu
explanationstringzorunlu
hintstring | nullisteğe bağlı

Hatalar

410application/json
Bu isteğin yanıtlandığı API sürümü sonlandırıldı. Lingara-Version içinde desteklenen bir sürüm gönderin veya istemciyi başka bir sürüme bağlayın.
4XXapplication/json
İstek reddedildi. code nedenini belirtir, error ise bunu sözcüklerle açıklar.
503application/json · text/plain
Hizmet geçici olarak kullanılamıyor; Retry-After içindeki saniye sayısı kadar bekledikten sonra yeniden deneyin. Bakım sırasında gövde, hata zarfı yerine düz metindir.
5XXapplication/json
İstek reddedildi. code nedenini belirtir, error ise bunu sözcüklerle açıklar.
codestringzorunlu

İsteğin neden reddedildiği, dallanmak için kullanılabilecek sabit bir kod olarak: örneğin insufficient_scope (403), rate_limited (429) ve kullanım başına ücretlendirilen bir istemci için spend_cap_reached (402) ile metered_billing_inactive (402).

errorstringzorunlu

Örnek

Kod örneğinin dili

curl

curl "https://api.getlingara.com/v1/lesson-plans/$ID" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

TypeScript

const plan = await client.getLessonPlan({ id: planId });
console.log(plan.status, plan.title);

Rust

let plan = client.get_lesson_plan(&plan_id).await?;
println!("{:?} {}", plan.status, plan.title.as_deref().unwrap_or("(untitled)"));

Go

plan, err := client.GetLessonPlan(ctx, "3f1c2a9e-5b7d-4e21-9a0c-6d8e4f2b1a37")
if err != nil {
	return err
}
fmt.Println(plan.Value.Status, plan.Value.CreatedAt)

Java

import com.getlingara.client.model.LessonPlan;

LessonPlan plan = client.getLessonPlan(planId).body();
System.out.println(plan.getTitle() + " (" + plan.getStatus() + ")");

Kotlin

val plan = client.getLessonPlan(planId).body
println("${plan.title} (${plan.status})")

Ruby

plan = client.get_lesson_plan(plan_id).value
puts "#{plan.title} (#{plan.status})"
plan.content&.vocabulary&.each { |word| puts "#{word.word}: #{word.translation}" }

PHP

$plan = $client->getLessonPlan($planId)->value;
echo $plan->getTitle(), ' (', $plan->getStatus()->value, ")\n";

Kütüphane mi tercih edersiniz? Kütüphaneler bölümüne bakın.

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