Canvas LMS数据访问

技能简介

该技能通过Canvas REST API连接Instructure Canvas学习管理系统，获取课程数据、作业、成绩和提交记录。

能做什么

• 查看用户个人资料和注册课程列表
• 获取待办事项和即将到期的事件
• 查询作业详情和提交状态
• 检索当前成绩和评分周期分数
• 访问课程公告、模块、文件和讨论区
• 查看收件箱对话消息

使用说明

安装准备

1. 在Canvas中生成API令牌：进入账户 → 设置 → 新建访问令牌
2. 配置环境变量或创建.env文件：

   export CANVAS_TOKEN="your_token_here"
   export CANVAS_URL="https://your-school.instructure.com"

发起请求

所有请求需携带授权头：

curl -s -H "Authorization: Bearer $CANVAS_TOKEN" "$CANVAS_URL/api/v1/..."

常用操作示例

• 获取活跃课程：/api/v1/courses?enrollment_state=active&per_page=50
• 查看待办事项：/api/v1/users/self/todo
• 查询课程作业：/api/v1/courses/{course_id}/assignments?per_page=50
• 获取成绩信息：/api/v1/users/self/enrollments?include[]=current_grading_period_scores

响应处理

列表端点返回数组；分页时检查Link头的rel="next"；日期为ISO 8601格式（UTC）。建议使用jq解析JSON，或备用Python脚本。

输入与输出

见下方输入与输出表格。

风险提示

• API令牌具有账户访问权限，需妥善保管，避免泄露
• 频繁调用可能触发速率限制，建议合理设置请求间隔
• 部分端点响应较慢，建议添加超时参数如--max-time 30
• 默认分页数量较小，需显式指定per_page参数获取更多结果

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/pranavkarthik10/canvas-lms/SKILL.md
来源类型：GitHub仓库