🧭 CollectX 使用指南

面向普通使用者,帮助你快速登录、找到接口、在线调试并稳定调用。

🚀 快速上手
  1. 打开 http://127.0.0.1:8081,点击右上角登录(无账号请联系管理员开通)。
  2. 进入 AI 助手 描述你的数据需求,系统会推荐接口或生成调用示例。
  3. 拿到接口路径与参数后,在你的应用或 Postman 中直接调用。
📁 平台可用入口
AI 助手

用自然语言描述需求,获取推荐接口、参数说明和示例调用。

个人中心

查看账号信息、使用指引(若无入口请联系管理员开启)。

接口调用

根据 AI 助手推荐的路径与示例,在任意 HTTP 客户端发起请求。

🧭 使用流程
  • 提出需求 在 AI 助手输入“想要 xx 平台的 yy 数据”,得到接口建议。
  • 确认参数 AI 会给出必填/可选参数及示例值,按需替换。
  • 复制示例 直接复制 curl/HTTP 示例到你的应用或测试工具。
  • 验证结果 观察响应是否包含所需字段,必要时补充参数后重试。
  • 反馈问题 若接口缺失或字段不全,在 AI 助手留言或联系管理员补充。
🤖 如何与 AI 助手沟通
描述越具体越好

说明平台、目标字段、时间范围、数量限制,例如“要 App Store 榜单前 50 名含评分和下载量”。

指出输出期望

告知需要的字段与格式(如 JSON 字段名),AI 会按需推荐或调整示例。

无法匹配时

提示“未找到合适接口”,请留言需求,管理员会补充接口后再通知。

🔍 常见排查
  • 401/403:确认已登录;若接口限制管理员,请联系管理员开权限或代为调用。
  • 404/405:可能接口名或方法不匹配,重新让 AI 助手生成示例或确认路径。
  • 返回数据缺字段:在 AI 助手留言需要的字段,管理员会补充后再试。
  • 请求超时/空数据:先缩小时间范围或分页参数;若仍异常告知管理员排查数据源。
📦 在自己应用里调用
  • 用 HTTP 客户端(curl、Postman、代码)直接调用 AI 提供的接口路径与示例参数。
  • 保持会话:若接口需要登录态,先在浏览器登录,再在同环境下调用;或让管理员提供 Token 方案。
  • 频率与配额:如遇限流请降低频率或与管理员沟通提升额度。
🛡️ 权限与支持
  • 普通用户可直接访问本指南、FAQ、AI 助手;管理入口若不可见,请勿强行访问,联系管理员协助。
  • 需要新增接口或字段时,直接在 AI 助手留言需求。
  • 紧急故障或数据差异,请备注接口名、时间范围、期望字段,方便快速排查。