Lingara Lingara ドキュメント 学習ガイド API ライブラリ アプリ 作成 ウェブ版
言語: 日本語

レッスンプランを取得

API バージョン 2026-10-affable-towhee

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

自分が所有するレッスンプランを返します。生成中のプランにはまだ content がありません。

スコープ lesson_plans:read

パラメーター

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

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";

ライブラリを使いたい場合は、ライブラリのセクションをご覧ください。

翻訳と英語版リファレンスの内容が異なる場合は、英語版リファレンスが正しいものとします。