Skip to main content

示例代码（集成方）

本页提供一些“端到端可落地”的集成方式，示例以片段为主，避免绑定具体框架。

1) Web 应用：登录后连接 Vocnet​

推荐做法：

  • 用户登录你的应用后，提供“连接 Vocnet”入口
  • 授权完成后把 access_token/refresh_token 绑定到你系统里的 userId
  • 后台任务用 refresh token 维护长期同步

参考：

2) 生词同步：批量写入与去重​

常见策略：

  • 在你侧给每个词条生成稳定的“外部来源 ID”（或通过标签标识来源）
  • 写入前先查询（按 term/language 或 filter 表达式）以避免重复
  • 对同一个用户的同一个 term/language 做幂等处理

过滤能力与用例见：

3) 复习：拉取卡片并提交结果​

典型流程：

  1. 拉取/选择 review plan（以你的产品设计为准）
  2. 拉取 flashcards
  3. 用户作答后提交结果
  4. 处理 401（token 过期/撤销）与 400/403（参数/权限）