Lingara Lingara 文档 学习指南 API 库 应用 构建 网页版
语言: 中文简体

获取课程计划

API 版本 2026-10-affable-towhee

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

返回你拥有的课程计划。仍在生成中的计划尚无 content。

权限范围 lesson_plans:read

参数

Lingara-Versionheaderstring可选
回应此请求所用的 API 版本。不提供时,访问令牌使用其客户端绑定的版本,不带令牌的请求使用当前版本。仍在开发中的版本只能通过在此指定来访问。未知版本会以 400 回应,代码为 api_version_unknown。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";

更喜欢用库?请参阅“库”部分。

如译文与英文参考文档不一致,以英文参考文档为准。