SuperAPI AI 工具集

directus-integration

数据与分析

查看项目

更新于 10-15 20:31

技能介绍

用途:帮助应用与 Directus 对接,以受控方式读写 Collections 数据,并让认证、查询和错误处理保持一致。

主要能力:

  • 通过 HTTP API 消费数据,标准流程为:认证获取 Access Token,用 GET /items/<collection> 查询,再用 POST/PATCH/DELETE 做变更并校验 payload。
  • 查询支持 fields(只取必要字段)、filter 与 sort、limit 加分页(page 或 cursor),仅在需要关系时使用 deep 查询。
  • 推荐使用 SDK(如 @directus/sdk),建立唯一的 directusClient 层,包含 base URL、刷新策略、超时/重试,并集中做响应到领域 DTO 的映射。
  • 错误按类别映射:401/403 处理会话与授权,404 资源不存在,409 版本/并发冲突,422 校验,5xx 内部错误(回退加日志)。

使用方式与规则:

  • 绝不能在移动端或浏览器暴露 admin/特权 token。
  • 每个应用/进程使用单例 client,并配置 base URL 与拦截器。
  • 必须处理 HTTP 错误与 Directus 返回消息,不吞掉失败。
  • 数据契约(DTO/类型)与 UI 代码分离。
  • 在服务端校验 ownership/role,按最小需要配置 CORS 与 Directus 侧规则。
  • 上传相关逻辑交由 directus-files,模型、权限、扩展、导入导出分别对应 directus-data-modeling、directus-auth-permissions、directus-extensions、directus-migrations-import-export。

适用场景:需要读取或写入 Directus Collections、构建统一数据访问层、规范错误与加载状态的前后端项目。

限制:官方文本暂未提供;SDK 具体版本、刷新策略实现细节、重试与超时参数、分页采用 page 还是 cursor 均未给出,需按项目实际情况确定。