核心功能
PrepSPSC PYQ API 是针对印度锡金邦公共服务委员会（SPSC）考试的专项备考工具，覆盖7,442道真实历年真题，支持27个科目和64种考试模式。API采用语义搜索+关键词混合匹配技术，可根据自然语言查询精准定位相关题目。
主要端点
- 语义搜索：
POST /pyq-api支持按主题、难度、认知层级筛选 - 模拟测试生成：
POST /pyq-api/mock-test可按真实考试模式自动生成难度均衡的试卷 - 进度追踪：完整的学习记录与性能分析系统
- 智能推荐：基于"高产出"标签(high_yield)识别重点题目
显著优势
- 真实题库：全部题目源自SPSC实际考试，含标准答案与详细解析
- 考试模式丰富：覆盖公务员、警察、医疗、工程、教育等64类岗位考试
- 教育元数据完整：每题标注难度(easy/medium/hard)、认知层级(remember/understand/apply)、时效性标记
- 混合搜索：向量相似度+关键词匹配，支持模糊查询
局限性与风险
- 地域限制：仅限锡金邦PSC考试，不适用于其他印度邦属或中央级考试(UPSC等)
- 语言覆盖：题目以英语为主，Nepali Literature等本地语言科目有限
- API稳定性：基于Supabase Edge Functions，依赖第三方基础设施
- 数据时效：Current Affairs类题目需设置
year_min参数过滤过期内容
适用人群
- 锡金邦政府职位备考者（Under Secretary、LDC、Police SI等）
- 需要真实PYQ作为训练数据的AI教育开发者
- 培训机构构建本地化模拟考试系统
安全考量
- 采用Bearer Token认证，密钥格式
sk_live_* - 免费层限速10次/分钟，需合理设计请求队列
- 用户数据通过
external_user_id隔离，符合基本隐私要求