核心用法
Digiforma Skill 通过 GraphQL API 与法国培训管理平台 Digiforma 交互，支持查询六大核心数据域：学员信息（trainees）、培训课程（trainingSessions）、培训项目（programs）、发票账单（invoices）、讲师档案（trainers）以及课程详情。采用 Bearer Token 认证，API 密钥通过环境变量 DIGIFORMA_API_KEY 注入。
典型查询场景
- 学员管理：按姓名搜索、分页列出学员联系信息
- 课程运营：查看课程状态（draft/planned/ongoing/completed/cancelled）、起止时间、关联项目
- 财务追踪：查询发票金额、状态、到期日及对应企业
- 讲师调度：获取讲师名录及联系方式
- 深度查询：单课程详情包含学员名单、指派讲师等多层嵌套数据
显著优点
1. GraphQL 灵活性：精准获取所需字段，避免 REST 过度获取
2. 标准化分页：统一 perPage/page 模式，支持最大 50 条/页
3. 多实体关联：单次查询可穿透项目-课程-学员-讲师多层关系
4. 状态机清晰：课程生命周期状态枚举完整
局限性与风险
- 地域限定：专为法国培训管理场景设计，国际化支持未知
- 认证单一：仅支持 Bearer Token，缺乏 OAuth 等进阶机制
- 写操作缺失：当前仅开放查询接口，无法创建或修改数据
- 速率限制未披露：未说明 API 限流策略
- 环境依赖：必须预配置
DIGIFORMA_API_KEY，无动态密钥获取能力
适合人群
- 法国职业培训机构（centre de formation）的运营人员
- 需要集成培训数据到内部系统的技术团队
- 处理学员注册、课程排期、发票对账的自动化工作流
常规风险
- 密钥泄露：API 密钥存储于环境变量，需确保 CI/CD 及运行时隔离
- 数据隐私：处理欧盟学员 PII 时需符合 GDPR 合规要求
- 查询复杂度：深层嵌套查询可能导致性能问题或超时