수업 계획 가져오기

매개변수

Lingara-Versionheaderstring선택

이 요청에 응답할 API 버전입니다. 지정하지 않으면 액세스 토큰은 해당 클라이언트에 고정된 버전을, 토큰이 없는 요청은 현재 버전을 받습니다. 개발 중인 버전은 여기에서 지정해야만 사용할 수 있습니다. 알 수 없는 버전에는 코드 api_version_unknown과 함께 400으로 응답합니다. GET /v1/versions에서 버전 목록을 확인할 수 있습니다.

idpathstring필수

응답

200 수업 계획

idstring필수

statusPlanStatus필수

titlestring | null선택

source_langstring필수

target_langstring필수

levelinteger필수

created_atstring필수

completed_atstring | null선택

ai_generatedboolean필수

contentLessonPlanContent | null선택

introductionstring | null선택

learning_objectivesarray of string필수

vocabularyarray of PlanWord필수

wordstring필수

pronunciationstring | null선택

translationstring필수

setsarray of PlanSet필수

numberinteger필수

contextstring | null선택

questionsarray of PlanQuestion필수

typestring필수

promptstring필수

optionsarray of string | null선택

answerstring필수

explanationstring필수

hintstring | null선택

오류

410application/json

이 요청에 응답하는 API 버전은 지원이 종료되었습니다. Lingara-Version에 지원되는 버전을 보내거나 클라이언트를 다른 버전에 다시 고정하세요.

4XXapplication/json

요청이 거부되었습니다. code는 이유를, error는 이를 문장으로 알려 줍니다.

503application/json · text/plain

서비스를 일시적으로 사용할 수 없습니다. Retry-After에 있는 초만큼 기다린 후 다시 시도하세요. 점검 중에는 본문이 오류 엔벨로프가 아닌 일반 텍스트입니다.

5XXapplication/json

요청이 거부되었습니다. code는 이유를, error는 이를 문장으로 알려 줍니다.

codestring필수

요청이 거부된 이유를 분기에 쓸 수 있는 안정적인 코드로 나타냅니다. 예: insufficient_scope(403), rate_limited(429), 사용량 기반 과금 클라이언트의 경우 spend_cap_reached(402)와 metered_billing_inactive(402).

errorstring필수

예시

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

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

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

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

import com.getlingara.client.model.LessonPlan;

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

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

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

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

라이브러리가 더 편하신가요? 라이브러리 섹션을 보세요.